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.

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

2️⃣ 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

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

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

4️⃣ Select the "Create Incident" action:

5️⃣ 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, view data (like public incidents and organisation settings), and view catalog types and entries.

6️⃣ 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.

7️⃣ 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?