Integration · Automations

Trigger an incident with the customer voice attached.

When a spec calls for one, fire a PagerDuty incident with the customer quotes already in the payload. The on-call team gets the context, not just the page.

Trigger PagerDuty incidents from a spec, with customer context attached.

— How it connects —

Four steps to a wired page.

01
Add an Events API v2 integration key.

Standard PagerDuty integration key. Encrypted at rest with Fernet.

02
Test the connection.

Circuit fires a dry-run event to confirm the key works.

03
Wire the hook manually.

Add the PagerDuty hook from Settings → Hooks. Circuit doesn’t auto-provision a PagerDuty hook — only GitHub, Slack and Linear get an auto-provisioned starting point on connect.

04
Trigger from a spec.

Fire manually from the spec, or wire your hook to fire on brief generation.

— What you get —

The page gets the why.

Customer quotes in the page.

The on-call engineer sees what customers said — not just “something is broken.”

Severity from urgency.

Circuit maps urgency to PagerDuty severity (critical / warning / info), so the right page gets the right escalation.

Wired through hooks.

PagerDuty triggers through the same hook architecture as Linear and GitHub. One place to manage automations.

— The proof —

Built on the real plumbing.

PagerDuty Events API v2 integration key, Fernet-encrypted. Severity mapping in backend/services/hooks/providers/pagerduty.py.

— Questions —

Asked and answered.

When would I use this?

Production incidents where the customer signal is the source — a spec triggered by a sudden wave of “checkout broken” feedback, for example. The page fires with the customer voice attached, so the on-call team sees what users are experiencing.

Is the integration key safe?

Fernet-encrypted at rest and only read at trigger time.

Why isn’t the PagerDuty hook auto-provisioned like Linear’s?

PagerDuty pages affect on-call rotations directly; Circuit defaults to letting you wire the hook deliberately. Add it from Settings → Hooks when you’re ready.

Why a separate hook from Linear?

Different purpose. Linear is for tracked engineering work; PagerDuty is for incident response. Same hook architecture — different downstream tools.

When a spec needs a page, the page gets the why.

— Related —

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