> ## 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

> Trigger incidents automatically from any app you connect through 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 Zapier action search" 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 showing the incident fields to configure" 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.
