Skip to main content
Linear is an issue tracker built around cycles, with built-in workflows for planning and triage. Connect it to AppSignal to turn error incidents into Linear issues, or link issues that already exist. You can then follow their status from the incident. Linear is a personal integration: each person with access to an app who wants to use this feature has to complete these steps themselves.

Adding Linear to your app

Linear works with OAuth, so you don’t need to manually enter any API tokens.
  1. Open the Linear integration screen for the app you want to link, and select Add new Linear integration.
  2. 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.
  3. 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.
AppSignal confirms which Linear organization and team the app is linked to. From that screen you can also select Unlink Linear from this app at any time. When new Linear features need more permissions, AppSignal shows a banner asking you to re-authorize your Linear integration. Select Re-authorize Linear to approve the new permissions.

Create Linear issues for incidents

Once Linear is linked, you can create a Linear issue for an error incident:
  1. Open the error incident’s details screen.
  2. In the Actions panel, select Send to Linear.
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 as https://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. An incident's Actions panel in AppSignal. A linked Linear issue has a Done status badge, and a linked GitHub issue has a Closed badge Status changes also show in the incident’s logbook. For example, when someone moves the issue from Todo to In Progress in Linear, the logbook records that change. The entry shows who made the change in Linear. If that person is a member of your AppSignal app and has added Linear, the entry shows their AppSignal name. Issues sent to Linear before AppSignal started following their status show no badge until their next status change.

Unlinking and revoking access

To disconnect Linear completely, remove it in AppSignal and in Linear:
  1. On the app’s Linear integration screen in AppSignal, select Unlink Linear from this app.
  2. In your AppSignal personal settings, open Integrations and select Manage integration and then Remove for the Linear integration.
  3. In Linear, open your Security & access settings. Under Authorized applications, hover over AppSignal and select Revoke access.
If anything went wrong while validating the integration you will be prompted with the error message. Feel free to contact us if you experience any problems while setting up this integration.

Integrations list