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

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

Step 2: Navigate to Account Integrations

1. In the User Settings page, click on the Account Integrations tab
2. 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

1. A modal dialog should appear on your screen
2. Click on 'Authorize with OAuth' to proceed with the authorization process
3. 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

1. Navigate to your GitHub organization settings
2. Go to Settings > Third-party Access > OAuth app policy
3. Ensure you don't have any restrictions set that would block the third-party application
4. 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

1. Navigate back to the User Homepage
2. Click on Find Your Team
3. 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

Additional Resources

• Disabling OAuth app access restrictions for your organization