Articles in this section

Set up a connection to PagerDuty

PagerDuty is a cloud-based incident management and response platform designed for IT operations, DevOps, and engineering teams. It helps organizations monitor systems, detect issues, and respond quickly to incidents to minimize downtime and ensure reliability

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose your PagerDuty API type:

  • REST: Manage incidents, services, users, and more. Integrate with monitoring tools and automate incident workflows.

  • Jira Server integration: Connect PagerDuty with Jira Server to synchronize incidents and issues. Streamline communication between operations and development teams.

  • Events: Send detailed event data with custom routing and deduplication for advanced integrations that require rich context and control.

API type: REST 

Auth type * 

Select your PagerDuty API authentication type (Token or OAuth 2.0).

OAuth 2.0 client * 

To add an OAuth 2.0 client and configure your credentials, click the plus ( + ) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource.

How to retrieve client ID and client secret:  

Grant type * 

Select your OAuth 2.0 grant type (either Authorization code or Authorization code with PKCE).

Scopes * 

Scopes are OAuth 2.0 permissions that PagerDuty defines to limit access to your account.

How to configure scopes 

API key * 

Enter your PagerDuty API key.

Multiple layers of protection, including AES 256 encryption, are in place to keep your API key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve the API key: 

API type: Jira Server integration 

Jira signature * 

Enter your Jira Server signature. For more information, see APIs.

OAuth 2.0 client * 

To add an OAuth 2.0 client and configure your credentials, click the plus ( + ) button. Click the edit (pencil.svg) button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource.

How to retrieve client ID and client secret: 

Grant type * 

Select your OAuth 2.0 grant type (either Authorization code or Authorization code with PKCE).

API type: Events 

Integration key * 

Enter your PagerDuty integration key.

Multiple layers of protection, including AES 256 encryption, are in place to keep your key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve the integration key: 

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see the Token auth and OAuth 2.0 auth universal connector documentation, respectively.

How to retrieve the client ID and client secret

  1. Sign in to your PagerDuty developer account.

  2. Navigate to Integrations Developer toolsApp registration.

  3. Click + New app.

  4. Enter an App name.

  5. Enter a Description.

  6. From Functionality, select OAuth 2.0.

  7. Click Next.

  8. From Configure OAuth 2.0, select Scoped OAuth or Classic user OAuth according to your requirement.

  9. Click + Add redirect URL and enter the Celigo integrator.io redirect URL.

  10. Click Add.

  11. Check the required Scopes.

  12. Click Register app.

  13. Copy the Client ID.

  14. Copy the Client secret.

How to retrieve the API key

  1. Sign in to your PagerDuty developer account.

  2. Navigate to Integrations > Developer tools > API access keys.

  3. Click + Create new API key

  4. Enter a Description.

  5. Click Create key

  6. Copy the API key.

How to retrieve the integration key

  1. Sign in to your PagerDuty developer account.

  2. Navigate to Integrations > Services.

  3. Click + New service

  4. Enter a Name.

  5. Click Next.

  6. Choose Generate a new escalation policy or Existing.

  7. Click Next.

  8. Choose the Alert grouping and Transient alerts as required.

  9. Click Next. For more information, see Create a service.

  10. In Integration, search and select Events API v1 for API type: Events v1 and Events API v2 for API type: Events v2.

  11. Click Create service.

  12. Copy the Integration key.

How to configure scopes

  1. Click Scope.

  2. To access all of the scopes in the API, click the » button.

    – or – 

    Check the scopes you want to add and click the > button.

  3. Click Save.

Additional references