---
title: "Incident.io"
canonical_url: "https://docs.getdx.com/connectors/incident-io/"
md_url: "https://docs.getdx.com/connectors/incident-io.md"
last_updated: "2026-05-08"
---

# Incident.io
By integrating Incident.io with DX, you can analyze incident data and metrics such as MTTR and Change Fail Rate, as well as incorporate incident data into DX scorecards. Please refer to the API documentation below and our [schema explorer](https://docs.getdx.com/schema/) to see what data DX imports.

## Prerequisites

To connect Incident.io to DX, you need:

- an API key
- ID of the custom field that holds service names in your Incident.io Catalog

## Setup instructions

Follow the steps below to connect Incident.io to DX.

#### Step 1

Log in to incident.io and navigate to Settings > API keys.

#### Step 2

Create a new API key with two permissions:

- View data, like public incidents and organization settings
- View catalog types and entries

#### Step 3

If you have a service catalog in IncidentIO, find the ID of the Custom Field that is [linked to your Catalog data](https://help.incident.io/en/articles/8061971-using-the-catalog) in order to associate incidents with services in DX.

#### Step 4

- Navigate to the connections page in DX and select "+ Connection" in the top right.
- Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

## API reference

The table below lists the specific API endpoints that are used by DX.


| Endpoint | Documentation |
|----------------------------------------------------------|---------------|
| /v2/incidents | [Link](https://api-docs.incident.io/tag/Incidents-V2) |
| /v2/users | [Link](https://api-docs.incident.io/tag/Users-V2) |
| /v2/custom_fields | [Link](https://api-docs.incident.io/tag/Custom-Fields-V2) |
| /v2/incident_roles | [Link](https://api-docs.incident.io/tag/Incident-Roles-V2) |
| /v1/incident_statuses | [Link](https://api-docs.incident.io/tag/Incident-Statuses-V1) |
| /v2/incident_timestamps | [Link](https://api-docs.incident.io/tag/Incident-Timestamps-V2) |
| /v1/severities | [Link](https://api-docs.incident.io/tag/Severities-V1) |
| /v1/incident_types | [Link](https://api-docs.incident.io/tag/Incident-Types-V1) |
| /v2/schedules | [Link](https://api-docs.incident.io/tag/Schedules-V2) |
| /v2/follow_ups | [Link](https://api-docs.incident.io/tag/Follow-ups-V2) |


## Errors

The table below lists potential error codes when adding a connection in DX.


| Error | Description |
|----------------------|------------------------------------------------------------------------------------------------------------------|
| `invalid_credentials` | Your API credentials entered are not valid. |
| `invalid_permissions` | Your API token does not have the permissions required by DX. |
| `invalid_configuration` | The catalog_type_id wasn't found in the custom fields list. |
---

## Sitemap

[Overview of all docs pages](/llms.txt)