Skip to main content
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
  1. In the Action section, search for “incident.io”:
Searching for incident.io in the Zapier action search
  1. Select the Create Incident action:
The Create Incident event selected for the incident.io app in a Zap action
  1. Click sign in to add an API key:
The Connect incident.io (1.0.0) step with its 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 organization settings), and view catalog types and entries. The Create API key drawer, with View data, Create incidents and View catalog types and entries ticked
  1. Paste the key into Zapier, and click Yes, Continue
Zapier's account prompt with the incident.io API key pasted in, above Yes, Continue
  1. 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 showing the incident fields to configure You can also pre-fill custom fields, and assign roles by either email address or Slack user ID.