By connecting Incident.io with DX, you can analyze incident data and metrics such as time to resolution. Please visit our schema explorer 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

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 so to associate incidents with services in DX.

Step 4

Navigate to the connector setup form in DX.
Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

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.