Okta SSO Integration Guide

This integration requires use of our v1 REST API which is currently in a decommissioning period, please contact support to gain access to a v1 REST API key to configure this integration.

For more information about the v1 REST API deprecation take a look at our FAQ here: https://v2.developer.pagerduty.com/v2/docs/v1-rest-api-decommissioning-faq

We are working with partners to upgrade integrations to use our v2 REST API.

Okta is a single-sign on provider, which makes it easy to manage your SAAS application logins and permissions. PagerDuty is available within the Okta app catalog, making it easy to manage access to your PagerDuty account. Follow this simple guide to get your Okta account tied to your PagerDuty account.

Please note that you must be the Account Owner of your PagerDuty account in order to make these changes. Additionally, SSO capabilities within PagerDuty are only available on our Standard and Enterprise plans. Please contact our sales team if you are interested in upgrading your plan.

Start in Okta

  1. Go to the Applications tab in the Okta Admin site, then click Add Application.

  2. Enter PagerDuty in the search box, then click the Add button for PagerDuty on the search results list.

  3. Enter your PagerDuty subdomain in the Organization Subdomain field and click Next.

  4. Click the SAML 2.0 radio button, then click View Setup Instructions. Follow the instructions in the guide that opens, which includes steps to perform in PagerDuty. Make sure the Application username format is set to Okta username. Click Next once you’ve completed the Setup Instructions.

  5. If you wish to enable Okta’s optional provisioning features, allowing you to create users in Okta from users in PagerDuty, check the Enable provisioning features box and follow the instructions provided on the right side of the page. Click Next when you are done or to skip this step.

  6. Select the Okta users that you would like to have access to PagerDuty, then click Next.

  7. Verify that the Username field for user-specific attributes contains the user’s valid email address, then click Done.

  8. You’re done! Users that have been given access to PagerDuty will now see the the PagerDuty app in the Okta dashboard and will be able to log in with just one click.

    Alternatively, when you go to your PagerDuty subdomain, you will be able to sign in using Okta by clicking Sign in with your Identity Provider.

Congratulations! You should now be able to use your Okta to login to PagerDuty!


I assigned the PagerDuty app to a new user in Okta, but the user can’t log in. Why was their user not created in PagerDuty?

You’ll want to make sure that the the Sign On settings tab of your PagerDuty app within Okta has Okta username selected for the Application username format as shown in step 4 of this guide. This will ensure that the user’s email address is filled in as the username when assigning PagerDuty to a new Okta user, as shown below:

“Custom” or other options for the Application username format may not include the user’s email address, which PagerDuty requires to create a new user.