Integrations / Incidents & monitoring

incident.io

Look up incidents and their updates, statuses and severities, declare incidents and share updates, and trigger workflows from incident.io incident, follow-up, alert, escalation and schedule events.

9 tools 14 trigger events

Tools

incident_io.list_incidents

List incidents, newest first, optionally only those in given status categories. Incident IDs look like 01FDAG4SAP5TYPT98WGR2N7W91.

status_categorysort_bypage_sizeafter

incident_io.get_incident

Get an incident by ID, e.g. 01FDAG4SAP5TYPT98WGR2N7W91, with its roles, custom fields and timestamps.

id*

incident_io.list_incident_updates

List the updates shared on an incident, with the status and severity each moved it to.

incident_id*page_size

incident_io.list_incident_statuses

List the account's incident statuses with their IDs and categories, for moving incidents between statuses.

incident_io.list_severities

List the account's severities with their IDs, lowest rank first.

incident_io.share_incident_update writes

Share an update on an incident with a message, and optionally move it to a new status or severity.

incident_id*idempotency_key*messageto_incident_status_idto_severity_id

incident_io.create_incident writes

Declare a new incident.

idempotency_key*namesummaryseverity_idincident_status_idincident_type_idmodevisibility

incident_io.api_get

Send a GET request to any incident.io API path under https://api.incident.io and return the response. For endpoints the named tools don't cover.

path*params

incident_io.api_request writes

Send a POST, PUT, PATCH or DELETE request to any incident.io API path under https://api.incident.io.

method*path*paramsbody

Tick Allow raw writes on the connection to add api_request, which can send POST, PUT, PATCH and DELETE requests to any incident.io API path.

Connect

  1. In incident.io, open Settings → API keys and create a key. Give it the roles your workflows need to view, create and update incidents. Roles can only be chosen when the key is created.
  2. Paste the key on the connection.
  3. To trigger workflows, open Settings → Webhooks, add an endpoint with the request URL shown on the connection page and the event types you need, and paste its signing secret on the connection.

Credentials

API key Webhook signing secret

incident.io API docs

Triggers

In incident.io, open Settings → Webhooks, add an endpoint with this URL and the event types to send, and paste the endpoint's signing secret on this connection.

Events

public_incident.incident_created_v2public_incident.incident_updated_v2public_incident.incident_status_updated_v2public_incident.follow_up_created_v2public_incident.follow_up_updated_v2public_incident.postmortem_document_status_updated_v1private_incident.incident_created_v2private_incident.incident_updated_v2public_alert.alert_created_v1public_alert.alert_resolved_v1public_escalation.escalation_created_v1public_escalation.escalation_status_updated_v1schedule.shift_change_v1status_page_incident.update_shared_v1
 trigger
kind: incident_io
connection: incident_io
events: [public_incident.incident_created_v2]
severities: [...]
modes: [...]

Your next automation is one sentence away.

14-day free trial with $5 of built-in AI included. Cancel anytime.

Start free trial Talk to us