Work management
Linear
Connect Linear through Atlas OAuth and verify bounded GraphQL operations.
What this connector does
- Start the Linear OAuth consent flow from Atlas and store encrypted connector tokens server-side.
- Show persisted connection status from the shared connector store.
- Run bounded Linear GraphQL issue reads/writes from explicit operator actions.
- Keep background task sync and webhook ingestion as separately verified scheduler workflows.
Before you begin
- You can edit the Atlas tenant Integrations settings.
- Your Atlas deployment has Linear OAuth client credentials configured.
- You can approve the Linear workspace that Atlas should connect to.
Get your credentials
Configure the Linear OAuth app
Create or open the Linear OAuth app used by Atlas and confirm the callback URL points at the Atlas connector callback route. Linear app settings
Set Atlas OAuth credentials
Set LINEAR_CLIENT_ID and LINEAR_CLIENT_SECRET on the Atlas API and restart the service if your platform requires it.
Start OAuth from Atlas
Open the Atlas Linear connector page, click Connect, approve Linear consent, and return to Atlas.
Verify the connection
Use the issue-read verification action to prove the stored credential can reach Linear GraphQL.
Operate background sync deliberately
Turn on scheduled task sync only after the team has retained workflow evidence for the deployment environment.
Required scopes and permissions
readwriteissues:createSetup checklist
- Confirm LINEAR_CLIENT_ID and LINEAR_CLIENT_SECRET are configured for the Atlas API.
- Click Connect and complete Linear OAuth consent.
- Confirm Atlas shows the persisted Linear workspace connection.
- Run the issue-read verification and confirm the operation completes without exposing provider payloads.
- Enable background sync only after the scheduler workflow has retained operational proof.
Troubleshooting
API key rejected
Use the OAuth Connect button for new installs. Legacy API-key registration is supported only for compatibility clients.
Verification cannot reach Linear
Confirm the OAuth app credentials, callback URL, and workspace consent before rerunning the issue-read check.
Verification fails before connect
Complete Linear OAuth consent before running provider operations.
Webhooks
Atlas can verify Linear webhook signatures when the deployment is configured for webhook delivery. Background ingestion is operated separately from the manual verification console.
Events Atlas listens for
- Issue create
- Issue update
- Project status update
Provider docs: https://developers.linear.app/docs/graphql/webhooks
Disconnect and data deletion
- Click Disconnect on the Atlas Linear connector page to revoke the stored Atlas connection.
- Open Linear workspace settings and remove the Atlas OAuth app grant if you want to revoke provider-side access immediately.
- Atlas does not cache Linear provider payloads in the browser.
Once you have the credentials above, paste them into the live connector page to finish connecting Linear.
Open the Linear connector page