Using Zapier
How to use Zapier to connect incident.io to other tools
incident.io Engineering Team avatar
Written by incident.io Engineering Team
Updated over a week ago

Connect your Zapier account with incident.io to declare incidents when something happens in another system.

First, install the incident.io Zapier app, by clicking "Accept Invite & Build a Zap" on this invite page.

Click "Create Zap" and choose a trigger from one of your other systems. For this example we're using the "incoming email" trigger:

New Inbound Email trigger

In the "Action" section, search for "incident.io":

Searching for incident.io in the "action" setup section

Select the "Create Incident" action:

Click "sign in" to add an API key:

"connect incident.io" box, with "Sign in" button

This will open a new window where you can paste in an API Key. Generate one from the "API Keys" section of our dashboard. You'll need to give it permission to create incidents, and view public incidents and organisation settings.

Create API key modal, with "Zapier" in the name field, and "View data, like public incidents and organisation settings" and "Create incidents" permissions checked

Paste the key into Zapier, and click "Yes, Continue"

"Allow Zapier to access your incident.io account" window, with the API Key field filled in.

Now configure the incident information: the minimum required fields are:

  • "idempotency key": we'll only ever create one incident for each unique value here, so this should be something that uniquely identifies the trigger. In this example, each email is assigned a "Message ID", so using that as the idempotency key means we'll only open one incident for each email.

  • Severity: select this from the dropdown

  • Visibility: whether this incident should be public or private

Set up action section, with "Raw Message ID" as the idempotency key, Major as the severity, and "Everyone in your Slack workspace (public) as the visibility

You can also pre-fill custom fields, and assign roles by either email address or Slack user ID.

Did this answer your question?