---
title: "PagerDuty"
canonical_url: "https://docs.getdx.com/connectors/pagerduty/"
md_url: "https://docs.getdx.com/connectors/pagerduty.md"
last_updated: "2026-06-08"
---

# PagerDuty
By integrating PagerDuty 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 PagerDuty to DX, you need:

- a PagerDuty [API token](https://developer.pagerduty.com/docs/ZG9jOjExMDI5NTUx-authentication)

## Setup instructions

Follow the steps below to connect PagerDuty to DX.

#### Step 1

Log in to your PagerDuty account and navigate to Integrations > API Access Keys.

#### Step 2

Click **Create a New API Key** and generate a new **read-only** key. This creates a general access REST API key with read-only access.

#### Step 3

- 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 |
|-----------------------------------------|------------------------------------------------------------------------------------------------------|
| /incidents | [PagerDuty API: List Incidents](https://developer.pagerduty.com/api-reference/9d0b4b12e36f9-list-incidents) |
| /analytics/raw/incidents | [PagerDuty API: Get Raw Data for Multiple Incidents](https://developer.pagerduty.com/api-reference/c2d493e995071-get-raw-data-multiple-incidents) |
| /services | [PagerDuty API: List Services](https://developer.pagerduty.com/api-reference/e960cca205c0f-list-services) |
| /users | [PagerDuty API: List Users](https://developer.pagerduty.com/api-reference/c96e889522dd6-list-users) |
| /teams | [PagerDuty API: List Teams](https://developer.pagerduty.com/api-reference/0138639504311-list-teams) |
| /incidents/{incidentId}/log_entries | [PagerDuty API: List Log Entries for an Incident](https://developer.pagerduty.com/api-reference/) |
| /oncalls | [PagerDuty API: List all of the on-calls](https://developer.pagerduty.com/api-reference/) |


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

## Sitemap

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