Skip to main content

Editing a GitHub App's permissions

After registering a GitHub App, you can modify your app's permissions.

Note: Updated permissions won't take effect on an installation until the owner of the account or organization approves the changes. You can use the InstallationEvent webhook to find out when people accept new permissions for your app. One exception is user-level permissions, which don't require the account owner to approve permission changes.

  1. In the upper-right corner of any page, click your profile photo, then click Settings.

    Screenshot of GitHub's account menu showing options for users to view and edit their profile, content, and settings. The menu item "Settings" is outlined in dark orange.

  2. In the left sidebar, click Developer settings.

  3. In the left sidebar, click GitHub Apps. GitHub Apps section

  4. To the right of the GitHub App you want to modify, click Edit.

  5. In the GitHub Apps settings sidebar, click Permissions & events.

  6. Under "Repository permissions", "Organization permissions", and "Account permissions" sections, modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read and write", or "No access" from the dropdown.

  7. Under "Subscribe to events", select any events to which you'd like to subscribe your app.

  8. Optionally, under "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests.

  9. Click Save changes.