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.
Last updated
Was this helpful?
Learn how to troubleshoot the GitHub app connection with step-by-step instructions. Configured when setting up Aviator FlexReview, MergeQueue, or Releases.
Last updated
Was this helpful?
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.
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:
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.
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:
and click on "GitHub apps". Then click "Configure" next to the Aviator app.
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:
Log onto Aviator and then go to this this url (replace the installation_id with the one from the URL above):
If the app is still not connected, please email us at howto@aviator.co.
