Set up PagerDuty Connector

• Latest Dynatrace
• How-to guide
• 3-min read
• Updated on Sep 01, 2026

Set up the PagerDuty Connector so that you can create incidents and send events from a workflow. Setup has two parts: a PagerDuty connection for every action except Send event, and a PagerDuty Events connection for Send event itself.

Prerequisites

You need the app-engine:apps:install permission.

Required Set up PagerDuty Connector

Use the PagerDuty Connector with a PagerDuty API key to automate incident creation and retrieve on-call information via the PagerDuty REST API.

Step 1: Grant permissions to Workflows

Workflows requires some permissions to run actions on your behalf. Other permissions are required by actions that come bundled with the PagerDuty Connector itself.

To fine-tune permissions granted to Workflows:

For more on general Workflows user permissions, see Manage workflow permissions.

Step 2: Create PagerDuty API key

To interact with PagerDuty, you need an API key. To learn how to obtain it, refer to the PagerDuty official documentation.

Step 3: Configure PagerDuty connection

You need a configured connection for each of your PagerDuty environments.

Optional Set up Events connection for Send event action

The Send event action uses the PagerDuty Events API v2 and requires a separate Events connection configured with a routing key. Use this connection to trigger, acknowledge, and resolve incidents in PagerDuty directly from a workflow.

Step 1: Get the routing key from PagerDuty

A routing key is a 32-character integration key that identifies the PagerDuty service integration or the global integration that receives events from Dynatrace.

To get the routing key, see the PagerDuty documentation:

Step 2: Configure PagerDuty Events connection

You need a configured events connection for each PagerDuty service that receives events from Dynatrace.

Additional notes

For more details, see Permissions and access.