Work management
Linear
Read and update Linear issues from Atlas.
What this connector does
- Connect Linear with your own sign-in. Atlas keeps the connection details encrypted.
- Show on the connector page whether Linear is connected.
- Read and update Linear issues whenever someone in Atlas asks for it.
- Automatic task sync is a separate step that you turn on when you are ready.
Before you begin
- You are an owner or administrator of your Atlas workspace.
- You can sign in to your Linear account and approve access for Atlas.
- Atlas looks after the Linear app on its side, so there is nothing for you to create or copy.
How to connect
Open Linear in Integrations
In Atlas, open Integrations and select Linear.
Press Connect
Atlas sends you to Linear to sign in. Sign in with the account you want to connect.
Approve access
Review the permissions that Linear lists and approve them. Atlas returns you to the connector page, which then shows the connection.
Check the connection
Select Test connection on the connector page. A passing result means Atlas can read from Linear.
Permissions Atlas asks for
readwriteSetup checklist
- Confirm you are an owner or administrator of your Atlas workspace.
- Open Integrations and select the connector.
- Press Connect and sign in to Linear.
- Review the permissions that Linear lists and approve them.
- Select Test connection and read the result.
Troubleshooting
Access key rejected
Use the Connect button for new connections. Linear access keys are accepted only for older connections.
Verification fails before connect
Complete Linear consent before using Linear actions in Atlas.
Connect says Linear is not available yet
Atlas has not enabled Linear for this deployment, so there is nothing for you to configure. Check again later.
The sign-in was cancelled
If you close the Linear screen or choose Cancel, Atlas does not connect. Press Connect again and approve the access.
Atlas asks you to reconnect
Linear can end a connection when access is revoked or a password changes. Press Reconnect on the connector page and approve the access again.
Event notifications
Atlas can verify Linear event signatures when live event delivery is set up for your Atlas. Background updates run separately from the manual check on the connector page.
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 app access if you want to revoke it immediately.
- Atlas does not cache Linear data in the browser.
When you are ready, open the live connector page and press Connect to finish connecting Linear.
Open the Linear connector page