Developer

GitHub

Link GitHub issues and pull requests to Atlas tasks so engineering work shows up next to product context.

AuthOAuth 2.0UpdatesReal-timeAvailable

What this connector does

Link GitHub issues and pull requests to Atlas tasks.
Pull repository, branch, and review metadata into Atlas project evidence.
Listen for pull-request and issue events to update Atlas task state.
Post Atlas updates back to GitHub as comments or status checks.

Before you begin

You can create an OAuth App or GitHub App on the organization that owns the repositories.
Branch protection rules allow status checks from third-party apps.
You have a sandbox repository to validate the first connection.

Get your credentials

Open Developer settings

Create a new OAuth App

Click New OAuth App, name it Atlas Connector, and set Homepage URL to https://YOUR-ATLAS-HOST/.

Set the callback URL

Set Authorization callback URL to https://YOUR-ATLAS-HOST/oauth/callback/github exactly.

Generate a client secret

After creating the app, click Generate a new client secret. GitHub shows the secret once.

Copy the client id and secret

Copy Client ID and Client secret into the Atlas GitHub connector settings page and click Save.

Required scopes and permissions

Read user profileread:user

Access private repositoriesrepo

Read organization membershipread:org

Manage webhook subscriptionsadmin:repo_hook

Setup checklist

Create the provider app in a sandbox or development workspace.
Add the Atlas redirect URL to the provider app configuration.
Copy the client id, client secret, or API key.
Paste the credentials into the Atlas connector settings page.
Click Connect and complete the provider sign-in screen.
Run Test connection from the connector page to verify health.

Troubleshooting

bad_verification_code
The OAuth code expired before Atlas could exchange it. Retry the connect flow.
redirect_uri_mismatch
Authorization callback URL must exactly match what Atlas sent.
Resource not accessible by integration
The OAuth App was not granted access to this repository. Use the org admin Approve flow.

Webhooks

Atlas creates a per-repository webhook subscription with a generated signing secret.

Events Atlas listens for

push
pull_request
issues
issue_comment
check_run

Provider docs: https://docs.github.com/webhooks

Disconnect and data deletion

Click Disconnect on the Atlas GitHub connector page to revoke the OAuth grant.
Open https://github.com/settings/applications and revoke the Atlas Connector authorization.
Atlas removes the per-repository webhook subscriptions automatically on disconnect.

Once you have the credentials above, paste them into the live connector page to finish connecting GitHub.

Open the GitHub connector page