Integration · Automations

A Linear issue, with the customer voice attached.

Two-way link. Push spec → Linear issue with the citations preserved; status polled back via SWR so the spec view reflects the issue’s state. The customer ‘why’ rides along.

Push specs to Linear with the customer context attached.

— How it connects —

Key in, team picked, spec out.

01
Add a Linear API key.

Personal API key — no OAuth. Fernet-encrypted at rest.

02
Pick a team.

Circuit verifies the key by reading your teams and organisation, then stores team_id, team_name and org_url_key.

03
Auto-provisioned hook, ready to enable.

AU18 sets up a disabled “Linear: Create issue on brief” hook for you to switch on when ready.

04
Push spec, pull status.

Push the spec and Circuit creates the Linear issue. Status comes back via SWR polling (every 30s while you’re on the spec, 120s in the background).

— What you get —

The why travels with the ticket.

Customer voice in the issue.

The exact quotes that drove the spec land in the Linear issue, so engineers see the why.

Two-way link.

Push spec → Linear issue, with status polled back via SWR. Inbound webhooks for real-time Linear status changes are planned.

No copy-paste tax.

One click, one issue, no manual transcription.

— The proof —

GraphQL verification reads viewer { organization { id name urlKey } teams { nodes { id name } } } — Circuit knows your team layout. Keys encrypted with Fernet.

— Questions —

Asked and answered.

Why personal API key, not OAuth?

Linear’s recommended path for app-style integrations. The key is encrypted at rest and validates against your organisation on every call.

Can one Circuit spec become multiple Linear issues?

Yes. A spec can spawn multiple issues — Circuit keeps the rollup view so you can see ship state across all of them.

Does the customer context travel into Linear?

Yes. The citations and customer quotes are included in the issue body, so engineers see who asked and what they said.

How fresh is the Linear status I see in Circuit?

Polled via SWR — 30 seconds while you’re looking at the spec, 120 seconds in the background. Real-time inbound webhooks are on the roadmap.

The customer ‘why’ belongs in the ticket.

— Related —

GitHub · PagerDuty · Cursor · All integrations

Part of Circuit’s autonomous product intelligence stack — see the full picture.