Troubleshooting GitHub app connection

Learn how to troubleshoot the GitHub app connection with step-by-step instructions. Configured when setting up Aviator FlexReview, MergeQueue, or Releases.

GitHub app connection is critical to configure when setting up FlexReview, MergeQueue or Releases. If your GitHub organization requires app approvals by GitHub admin, and you are not one of those admins, the connection request goes through an approval.

Pending approval workflow

GitHub app connection via request-approval workflow is not supported natively within GitHub. We have an open ticket requesting GitHub to add that support.

Follow the following steps to handle the pending approval workflow:

1. Discuss with the GitHub admin

Ensure that your GitHub admin team is aware of this integration. You may have to ask them to approve the request manually. Typically they would receive an email with the link to review and approve the request. They may sometimes need to understand the usage of the app, you can share our GitHub App permissions guidelines for their reference.

An easier path to getting this connection work seamlessly is inviting them to the Aviator account. If they log into the Aviator account before going through the approval workflow, the app connection is automatically set up.

2. Get installation ID

So, if you have gotten approval from admin, but they were not already logged in to Aviator, the connection would not have established automatically.

In that case, go to GitHub organization settings:

https://github.com/organizations/<org_name>/settings/profile

and click on "GitHub apps". Then click "Configure" next to the Aviator app.

Configure button on the GitHub apps page

On this page, you will see the installation_id in url. The url will be of the format and installation_id is the number in the end:

https://github.com/organizations/<org_name>/settings/installations/<installation_id>

3. Complete the installation

Log onto Aviator and then go to this this url (replace the installation_id with the one from the URL above):

https://app.aviator.co/api/setup/complete?setup_action=install&installation_id=<installation_id>

If the app is still not connected, please email us at [email protected].