Linear integration: incidents to issues
Owner Theo Hayashi · Last updated 2026-03-14 · v2.1
linearintegrationissuesincident-to-ticketworkflow
Linear integration
DevFlow can create a Linear issue from an incident, automatically or on a button click.
install
Settings → Integrations → Linear → Install. The OAuth flow needs read+write on issues for the team you intend to write to.
attaching to a project
bash
devflow integrations linear configure --team ENG --label "incident,from-devflow" --auto-create-on critical--auto-create-on critical makes any critical-severity incident auto-create a Linear issue. Otherwise, the incident page has a "Create Linear issue" button.
what's in the issue
- Title —
[DevFlow] payments-api-charge — 2026-04-15 14:32 UTC - Description — incident metadata, link back to DevFlow, assertion that failed, region quorum.
- Labels —
incident,from-devflow, plus your configured labels. - Project — defaults to none; you can set per-tag-selector mapping in the dashboard.
status sync
When the Linear issue is moved to Done, the DevFlow incident gets a "linked Linear issue resolved" annotation. We do not auto-resolve the DevFlow incident on Linear status — auto-resolve in DevFlow follows the incident-management rules.
removing
OAuth grant can be revoked from Linear; DevFlow detects within 60s.