Overview

This article provides step-by-step instructions for setting up OAuth app integration with newer GitHub organizations. If you're experiencing issues setting up your GitHub OAuth app integrated organization, follow the troubleshooting steps outlined below.

Step 1: Access User Settings

Click on the profile icon in the top right corner of the interface
Select User Settings from the dropdown menu

Step 2: Navigate to Account Integrations

In the User Settings page, click on the Account Integrations tab
Click on the hyperlink "Received instructions from the CircleCI Support team to authorize a GitHub OAuth App? Click to be redirected" at the bottom of the page

Note: If the hyperlink isn’t visible, check whether the GitHub tile appears under your User ID in the Account Integrations tab. If it does, your account is already linked—go ahead and skip to Step 5.

Step 3: Authorize OAuth Connection

A modal dialog should appear on your screen
Click on 'Authorize with OAuth' to proceed with the authorization process
Follow any additional prompts to complete the OAuth authorization

Step 4: Verify Organization Access

After granting permission and authorizing with OAuth, you should now see new GitHub OAuth organizations displayed on your User Homepage. If you don't see your new GitHub OAuth organization, follow these additional steps:

Step 5: Check OAuth App Policy in GitHub

Navigate to your GitHub organization settings
Go to Settings > Third-party Access > OAuth app policy
Ensure you don't have any restrictions set that would block the third-party application
The settings should allow third-party application access (see organization's OAuth app access restrictions documentation here)

Step 6: Re-authenticate Through Team Join Process

Navigate back to the User Homepage
Click on Find Your Team
Select Join via GitHub from the dropdown menu

Step 7: Handle Redirect Issues

If you get redirected to an unexpected page or encounter authentication errors, log out of your current session and sign back in.

Step 8: Verify Final Setup

After signing back in, you should see your organization displayed on the user homepage.

Additional Notes

OAuth app access restrictions are enabled by default for new GitHub organizations
Organization owners may need to approve third-party applications before they can access organization resources
If issues persist after following these steps, contact Support with details about your specific organization setup