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

# Incident.io

> Connect incident.io to Paradime to automatically create incidents when your Bolt pipelines fail, and manage them through Slack-native incident workflows.

[incident.io](https://incident.io/) is a Slack-native incident management platform. Connecting incident.io to Paradime automatically creates incidents in incident.io whenever a Bolt schedule fails, so your team can track and resolve dbt™ pipeline issues through your existing on-call and postmortem workflows.

## What you can do

* Automatically create incidents when dbt™ runs fail
* Leverage Slack-native incident management workflows
* Track MTTR and incident frequency for data pipelines
* Integrate pipeline failures with your on-call rotation
* Maintain centralized incident tracking across your organization
* Use incident.io's timeline and postmortem features for pipeline issues

Paradime uses the incident.io API to automatically create incidents for [Bolt Schedules](/products/bolt/index).

## Prerequisites

Before connecting incident.io to Paradime, make sure you have:

* An existing Bolt schedule
* incident.io account with API access
* incident.io API Key
* Configured severity levels in incident.io

## Step 1: Gather your incident.io information

**1. Generate API Key**

* Navigate to [https://app.incident.io/settings/api-keys](https://app.incident.io/settings/api-keys)
* Click **Create API Key**
* Give it a descriptive name (e.g., "Paradime Integration")
* Copy and save your API key securely

<Warning>
  **Important:** Store your API key securely. You will need it to configure the Paradime integration.
</Warning>

## Step 2: Connect incident.io to Paradime

1. In Paradime, go to **Settings → Integrations** (see [connecting integrations](/integrations/connecting-integrations)), and find **incident.io**.
2. Paste your incident.io API Key into the field provided.
3. Click **Create** to establish the connection.

Once connected, Paradime will automatically create incidents in incident.io whenever Bolt runs fail.

<Frame>
  <img src="https://mintcdn.com/paradime-docs/_V48tdxcy1g_Y-dv/images/image-2-1-1-1-1.png?fit=max&auto=format&n=_V48tdxcy1g_Y-dv&q=85&s=ad67cd80e8401765923f23a352eef899" alt="" width="1430" height="982" data-path="images/image-2-1-1-1-1.png" />
</Frame>

## Step 3: Enable incident.io for your Bolt schedules

After enabling the integration, you can configure which Bolt Schedules should create incidents in incident.io when they fail.

To configure incident creation:

1. Navigate to **Bolt** > **Schedules** in the Paradime interface.
2. Select the schedule you want to monitor.
3. Open the [**Integration Settings**](/products/bolt/creating-schedules/trigger-integrations/trigger-incident.io-incidents) for that schedule.
4. Enable **incident.io Incident Creation** to automatically create incidents in incident.io when the schedule fails.

Once enabled, any failures in the configured Bolt Schedules will automatically trigger incident creation in incident.io, allowing your team to respond quickly to data pipeline issues.


## Related topics

- [Create Incident in incident.io](/products/bolt/creating-schedules/templates/incident-templates/create-incident-in-incident.io.md)
- [Trigger incident.io Incidents](/products/bolt/creating-schedules/trigger-integrations/trigger-incident.io-incidents.md)
- [Incident Templates](/products/bolt/creating-schedules/templates/incident-templates/index.md)
- [Bolt Trigger Integrations](/products/bolt/creating-schedules/trigger-integrations/index.md)
- [Integrations](/integrations/index.md)