Introduction

To enable the PagerDuty connector, you need an API token.

Steps to connect

Step 1 must be completed by a PagerDuty admin user.

Click 'Create a New API Key' and generate a new read-only key.

Navigate to the Data Cloud > Connections screen within DX, then add a connection using your credentials generated in the previous steps.

Endpoint	Documentation Link	Required Permissions
/incidents	PagerDuty API: List Incidents	General Access REST API Key with Read-Only Access
/analytics/raw/incidents	PagerDuty API: Get Raw Data for Multiple Incidents	General Access REST API Key with Read-Only Access
/services	PagerDuty API: List Services	General Access REST API Key with Read-Only Access
/users	PagerDuty API: List Users	General Access REST API Key with Read-Only Access
/teams	PagerDuty API: List Teams	General Access REST API Key with Read-Only Access
/incidents/{incident_id}/log_entries	PagerDuty API: List Log Entries for an Incident	General Access REST API Key with Read-Only Access

This table lists error codes that you may encounter 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.