Adding Linear to your app
Linear works with OAuth, so you don’t need to manually enter any API tokens.- Open the Linear integration screen for the app you want to link, and select Add new Linear integration.
- Linear asks you to approve AppSignal’s access. AppSignal requests read and write access to your Linear account, and permission to create and update issues. Approve the request.
- You return to AppSignal with your Linear account linked. In the table of Linear apps, choose the Linear team you want to use, then select Link Linear app.
Create Linear issues for incidents
Once Linear is linked, you can create a Linear issue for an error incident:- Open the error incident’s details screen.
- In the Actions panel, select Send to Linear.
Link an existing Linear issue
Sometimes the bug is already in Linear: a teammate filed it after a customer report, before the error reached AppSignal. Paste the issue’s link in a note, and AppSignal links it to the incident. Anyone who opens the incident can see the fix is already tracked. Open the incident’s Summary tab. Write a note in the Logbook box with the Linear issue URL, and select Post note. AppSignal links every Linear issue URL in the note, such ashttps://linear.app/acme/issue/APP-123/fix-checkout-timeout.
The logbook records that you linked the issue, with its Linear identifier linking to it. The issue also appears in the Actions panel with its status.
The AppSignal MCP server links issues the same way when an AI agent writes a note on an incident.
What AppSignal links, and what it skips:
- You need to have added Linear to the app yourself, because AppSignal looks up the issue with your Linear account.
- AppSignal only links issues from the Linear workspace you linked to this app. Your Linear account also needs access to them. It skips other URLs without failing the note.
- Only full URLs are linked. An issue identifier, such as
APP-123, on its own is not. - An issue that is already linked is not linked again, so editing the note does not create duplicates.
Follow linked issues from the incident
The Actions panel shows a View in Linear button for every linked Linear issue. Its label includes the issue’s Linear identifier. Select it to open the issue in Linear, or to re-create the issue. Each button shows the issue’s status as a badge, such as To do, In Progress, or Done. The badge uses your team’s own workflow state names. AppSignal reads the status when you create or link an issue. It updates the badge whenever someone moves the issue to another state in Linear. You don’t need to set anything up for this.
Unlinking and revoking access
To disconnect Linear completely, remove it in AppSignal and in Linear:- On the app’s Linear integration screen in AppSignal, select Unlink Linear from this app.
- In your AppSignal personal settings, open Integrations and select Manage integration and then Remove for the Linear integration.
- In Linear, open your Security & access settings. Under Authorized applications, hover over AppSignal and select Revoke access.