Skip to main content
GitHub AE is currently under limited release.

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.

    Settings icon in the user bar

  2. In the left sidebar, click Developer settings. Developer settings

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

  4. Select the GitHub App whose permissions you want to change. App selection

  5. In the left sidebar, click Permissions & webhooks. Permissions and webhooks

  6. Modify the permissions you'd like to change. For each type of permission, select either "Read-only", "Read & write", or "No access" from the dropdown. Permissions selections for your GitHub App

  7. In "Subscribe to events", select any events to which you'd like to subscribe your app. Permissions selections for subscribing your GitHub App to events

  8. Optionally, in "Add a note to users", add a note telling your users why you are changing the permissions that your GitHub App requests. Input box to add a note to users explaining why your GitHub App permissions have changed

  9. Click Save changes. Button to save permissions changes