Set up a connection to PagerDuty Events

PagerDuty Events documentation: API guide, Authentication, Supported endpoints

PagerDuty is an incident management platform that provides reliable notifications, automatic escalations, on-call scheduling, and other functionality to help teams detect and fix infrastructure problems quickly.

A. Set up a PagerDuty Events connection

Start establishing an OAuth 2.0 connection to PagerDuty Events in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
      – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select PagerDuty Events.

The Create connection pane opens with required and advanced settings.

B. Edit PagerDuty Events application details

At this point, you’re presented with a series of options for providing PagerDuty Events authentication.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing. 

Application details

Routing key (required): Enter your PagerDuty Events routing key. Use the following steps to retrieve your routing key from PagerDuty.

1. Log in to your PagerDuty account.
2. From the dashboard, click Integrations, and in the Developer Tools section, click Developer Mode.

3. Select the app (or create one), and in the Functionality section, click Manage in the Events Integration section.

4. Copy the integration key from the Events API Endpoint URL.

The endpoint URL has the following formatting:

https://events.pagerduty.com/integration/<Integration Key>/enqueue

5. Copy the <Integration Key> value to use as the routing key.

Redirect URL (read-only): Copy this integrator.io callback URL when creating your PagerDuty Events app for where to go after authentication. (This URL should be whitelisted with the authorization server.)

https://integrator.io/connection/oauth2callback

C. Edit advanced PagerDuty Events settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the PagerDuty Events connection.

Borrow concurrency from (optional): Select another connection from the list....

Concurrency level (optional): Up to 25 allowed....

D. Test the connection

Once you have configured the PagerDuty Events connection, you have a few options for continuing:

• Save – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account
• Save & close – click to test and save the connection and exit the Create connection pane
• Close – click to exit without saving any new changes
• Test connection – click this button to verify that your new connection is free of errors

When you test or save the connection, it is verified before continuing. 

The new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.