> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Using Zapier

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](https://zapier.com/developer/public-invite/162447/c60b514649e6aeb2a3d29594e7943a9d/).

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

<img src="https://mintcdn.com/incidentio-18bb4170/zaR7zcu-VIqt5-ZN/images/help-centre/using-zapier/screenshot-1.png?fit=max&auto=format&n=zaR7zcu-VIqt5-ZN&q=85&s=01c83e2788da048c205b495f3674ca70" alt="New Inbound Email trigger" width="1830" height="1208" data-path="images/help-centre/using-zapier/screenshot-1.png" />

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

<img src="https://mintcdn.com/incidentio-18bb4170/zaR7zcu-VIqt5-ZN/images/help-centre/using-zapier/screenshot-2.png?fit=max&auto=format&n=zaR7zcu-VIqt5-ZN&q=85&s=cc5f9606c3c64262eddba449e811659a" alt="Searching for incident.io in the " width="1848" height="1338" data-path="images/help-centre/using-zapier/screenshot-2.png" />

4. Select the "Create Incident" action:

<img src="https://mintcdn.com/incidentio-18bb4170/zaR7zcu-VIqt5-ZN/images/help-centre/using-zapier/screenshot-3.png?fit=max&auto=format&n=zaR7zcu-VIqt5-ZN&q=85&s=660987ed95718d201fb29646dbaae317" alt="" width="1844" height="1108" data-path="images/help-centre/using-zapier/screenshot-3.png" />

5. Click "sign in" to add an API key:

<img src="https://mintcdn.com/incidentio-18bb4170/zaR7zcu-VIqt5-ZN/images/help-centre/using-zapier/screenshot-4.png?fit=max&auto=format&n=zaR7zcu-VIqt5-ZN&q=85&s=4fba07875bf4c3ed7273348b520b0f35" alt="" width="1712" height="194" data-path="images/help-centre/using-zapier/screenshot-4.png" />

This will open a new window where you can paste in an API Key. Generate one from the ["API Keys" section of our dashboard](https://app.incident.io/~/settings/api-keys). You'll need to give it permission to create incidents, view data (like public incidents and organization settings), and view catalog types and entries.

<img src="https://mintcdn.com/incidentio-18bb4170/zaR7zcu-VIqt5-ZN/images/help-centre/using-zapier/screenshot-5.png?fit=max&auto=format&n=zaR7zcu-VIqt5-ZN&q=85&s=48564426b37f675be055f258b01077b4" alt="" width="837" height="814" data-path="images/help-centre/using-zapier/screenshot-5.png" />

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

<img src="https://mintcdn.com/incidentio-18bb4170/zaR7zcu-VIqt5-ZN/images/help-centre/using-zapier/screenshot-6.png?fit=max&auto=format&n=zaR7zcu-VIqt5-ZN&q=85&s=9ce10f27223e955c7e6cf721a95c7eef" alt="" width="1156" height="678" data-path="images/help-centre/using-zapier/screenshot-6.png" />

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

<img src="https://mintcdn.com/incidentio-18bb4170/zaR7zcu-VIqt5-ZN/images/help-centre/using-zapier/screenshot-7.png?fit=max&auto=format&n=zaR7zcu-VIqt5-ZN&q=85&s=f54c6099820d8bd420a3d58372d69c09" alt="Set up action section, with " width="1800" height="776" data-path="images/help-centre/using-zapier/screenshot-7.png" />

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