Configuring Provisioning for PagerDuty

This guide provides the steps required to configure Provisioning for PagerDuty and includes the following sections:



You need to complete the following before you can configure provisioning for PagerDuty:

Generate a new API key from PagerDuty:

  1. Login to your PagerDuty account as an Administrator.

  2. Select API Access from the Configuration menu:

  3. “pagerduty1.png”

  4. Click Create New API Key:


  5. In Create API Key, enter a description, then click Create Key:


Configuration Steps

Configure your Provisioning settings for PagerDuty as follows:

  1. Check the Enable API Integration box.

  2. Enter your PagerDuty API Credentials:

    • API Key: Enter the API Key you generated earlier, see Requirements above, for details.

    • Admin Username: Enter an admin username with admin or owner permissions.

    • pagerdutyprovisioning1.png

  3. Select To App in the left panel, then select the Provisioning Features you want to enable:


  4. Click Save.

  5. You can now assign people to the app, if needed (see below).

User Assignment

To assign users to the PagerDuty app:

  1. In Okta, Navigate to the Assignments tab of your PagerDuty app, click Assign, then click Assign to People.


  2. In the Assign PagerDuty to People dialog, select a user, then click Assign:


  3. You can also set the User Role for the PagerDuty user:


Schema Discovery

PagerDuty supports the following 2 attributes with schema discovery:

PagerDuty requires the country code to be a separate value. The PagerDuty integration expects phone numbers and SMS numbers to be in the following format:


For example: +1-202-555-0103 must be provided as +1 2025550103

To use provide mastering you need to convert phone/SMS numbers during mapping, as described below:

To convert the number +1-202-555-0103 to the correct format +1 2025550103, you can use the following mapping:

String.join(" ", String.substring(String.replace(String.replace(user.mobilePhone, "-",""), "+",""), 0,1), String.substring(String.replace(String.replace(user.mobilePhone, "-",""), "+",""), 1,String.len(String.replace(String.replace(user.mobilePhone, "-",""), "+",""))))

Without Schema Discovery

With Schema Discovery