Skip to main content
This guide walks you through connecting incident.io to Clarion. Once connected, agents can create alerts in incident.io — handing them off to your on-call and escalation policies — and, optionally, use incident.io’s incident-management tools (incidents, alerts, on-call schedules, escalations) to investigate during triage.
Estimated time: 5 minutes. You’ll need permission to create an HTTP alert source in incident.io, and (optionally) an API key for the incident-management tools.

​
Prerequisites

  • An incident.io account with permission to manage alert sources
  • A Clarion workspace with the incident.io integration page open

​
Step 1 — Create an HTTP alert source in incident.io

For each destination Clarion should be able to raise alerts on:
  1. In incident.io, go to Alerts → Alert sources.
  2. Create a new HTTP alert source and give it a recognisable name, for example Clarion — Production.
  3. Copy the alert source config ID shown in the source’s URL and the bearer token incident.io generates for it.
Each alert source maps to one incident.io routing configuration. Create one per scenario if you want different alerts to follow different paths.

​
Step 2 — Add the alert source in Clarion

  1. In Clarion, open Integrations and find incident.io.
  2. Under Alert sources, click Add alert source.
  3. Enter a name, the alert source config ID, and the bearer token from Step 1.
  4. Click Connect incident.io (or Add alert source if already connected).
Use the Test button next to a source to send a test alert and immediately resolve it, confirming the config ID and token are valid.

​
Step 3 (optional) — Enable the incident-management tools

To let agents look up and manage incidents, alerts, on-call schedules, and escalations during triage:
  1. In incident.io, create an API key under Settings → API keys.
  2. In Clarion’s incident.io integration page, paste the key under MCP access and click Save.
Write actions (creating or updating incidents, responding to escalations, starting analyses) always pause for human approval before they run.

​
Using incident.io in a skill

Add the incident.io tools to a skill or workspace prompt so the agent can create an alert — or take other incident-management actions — when it decides, based on what it found during triage, that a situation warrants it. The incident.io alert links back to the originating Clarion issue.