Skip to content
Notis

Scheduled Team Permission Audit

Every month, Notis audits your team's GitHub repository permissions and sends you a report. Catch access creep and misconfiguration before they become problems.

Trigger

Recurring schedule

Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.

Action

Check team permissions for a repository

Checks a team's permissions for a specific repository within an organization, including permissions inherited from parent teams.

Why this helps

Over time, people accumulate permissions they don't need. You don't know if a team still has the right access level to a repository, and auditing manually is tedious.

  • Detect over-permissioning and security gaps
  • Ensure teams have appropriate access levels
  • Maintain audit trail of permission changes
  • Reduce human error in permission management

Setup

Build it in a few focused steps.

  • 1Connect GitHub to Notis.
  • 2Create a cron automation: "On the first Monday of each month, audit all team permissions in [repository] and send me a report of who has what access."
  • 3Choose which repositories to audit or set it to 'all'.
  • 4Review the monthly report and adjust permissions as needed.

Questions about this workflow

Can Notis auto-fix permissions it finds to be wrong?

Not automatically, but you can approve changes in the report and Notis will apply them.

What does the report look like?

A table showing each team, their permission level per repository, and when it was last changed.

Can I set a different audit frequency?

Yes—weekly, monthly, quarterly, or custom intervals.

When this happens · Trigger

Do this · Action

Supported Triggers and Actions

Notis builds workflows that link Gmail to GitHub. A trigger fires from one place; an action lands in another.

Gmail triggers

GitHub actions

Email Sent

Triggers when a Gmail message is sent by the authenticated user. It polls the 'SENT' label and emits metadata including sender, recipients, subject, timestamp, and thread ID.

TriggerPolling

Accept a repository invitation

Accepts a pending repository invitation that has been issued to the authenticated user.

ActionInstant

New Gmail Message Received Trigger

Triggers when a new message is received in Gmail.

TriggerPolling

List repositories starred by the authenticated user

Deprecated: lists repositories starred by the authenticated user, including star creation timestamps; use 'list repositories starred by the authenticated user' instead.

ActionInstant

List stargazers

Deprecated: lists users who have starred a repository; use `list stargazers` instead.

ActionInstant

Star a repository for the authenticated user

Deprecated: stars a repository for the authenticated user; use `star a repository for the authenticated user` instead.

ActionInstant

Add email for auth user

Adds one or more email addresses (which will be initially unverified) to the authenticated user's github account; use this to associate new emails, noting an email verified for another account will error, while an existing email for the current user is accepted.

ActionInstant

Add app access restrictions

Replaces github app access restrictions for an existing protected branch; requires a json array of app slugs in the request body, where apps must be installed and have 'contents' write permissions.

ActionInstant

Add a repository collaborator

Adds a github user as a repository collaborator, or updates their permission if already a collaborator; `permission` applies to organization-owned repositories (personal ones default to 'push' and ignore this field), and an invitation may be created or permissions updated directly.

ActionInstant

Add a repository to an app installation

Adds a repository to a github app installation, granting the app access; requires authenticated user to have admin rights for the repository and access to the installation.

ActionInstant

Connect any two apps with Notis in the middle.

Not just Gmail and GitHub. Any combination from 1,000+ integrations.

When this happens · Trigger

Do this · Action

Save your first hour today.

7 days free trial with 20$ free usage included.
No card. Works with personal or business GitHub.