> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PagerDuty OAuth 2.0 connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 for PagerDuty in StackOne to allow users to link their accounts.

> [!WARNING]
>
> App Registration is available only to users with a base role of Manager, Global Admin or Account Owner. A Scoped OAuth app works on the PagerDuty account that registered it as soon as it is saved. To connect accounts belonging to other PagerDuty customers, publish the app and have an admin on each of those accounts install it.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Registering a PagerDuty app with Scoped OAuth

Register an app on your PagerDuty account and give it Scoped OAuth functionality to obtain the Client ID and Client Secret.

**1. Create the app**

Sign in to [PagerDuty](https://app.pagerduty.com), then open **Integrations** > **App Registration**.

<ul>
  <li>Click **+ New App**.</li>
</ul>

![The Integrations menu with App Registration highlighted under Developer Tools.](https://mintcdn.com/stackone-60/Gb5xYa94zdUk8qUq/connectors/pagerduty/images/oauth2-setup-app-registration.png?fit=max\&auto=format\&n=Gb5xYa94zdUk8qUq\&q=85\&s=26a96a9517f1e2a514fad2e782ed6e87)

**2. Name the app and turn on OAuth 2.0**

The **Add New App** form opens on **Info & Functionality**.

<ul>
  <li>**Name**: `StackOne Integration`</li>
  <li>**Description**: `Integration with StackOne`</li>
  <li>Under **Functionality**, select **OAuth 2.0**.</li>
  <li>Click **Next**.</li>
</ul>

![The Add New App form with the Name field, Description field and OAuth 2.0 checkbox highlighted.](https://mintcdn.com/stackone-60/Gb5xYa94zdUk8qUq/connectors/pagerduty/images/oauth2-setup-add-new-app.png?fit=max\&auto=format\&n=Gb5xYa94zdUk8qUq\&q=85\&s=916d00562497d3a3e5c0a43ebe69e1ec)

**3. Choose Scoped OAuth**

On **Configure OAuth 2.0**, pick the OAuth type under **Authorization**.

<ul>
  <li>Select **Scoped OAuth**. It grants access per resource type, rather than everything the authorizing user can reach.</li>
  <li>Leave **Confidential client** selected. StackOne keeps the Client Secret on its own servers and sends it on the token request.</li>
</ul>

![The Authorization section with Scoped OAuth selected and Confidential client checked.](https://mintcdn.com/stackone-60/Gb5xYa94zdUk8qUq/connectors/pagerduty/images/oauth2-setup-scoped-oauth.png?fit=max\&auto=format\&n=Gb5xYa94zdUk8qUq\&q=85\&s=28d6d74cd2d223157a9c26ad14802225)

**4. Set the redirect URL**

Under **Redirect URL**, click **+ Add Redirect URL**.

<ul>
  <li>**Redirect URL**: the **Callback URL** from your Connector Profile</li>
  <li>PagerDuty compares the redirect URL with its saved value exactly, so copy it without changes.</li>
</ul>

![The Redirect URL field holding the callback URL, above the Permission Scope table.](https://mintcdn.com/stackone-60/Gb5xYa94zdUk8qUq/connectors/pagerduty/images/oauth2-setup-redirect-url.png?fit=max\&auto=format\&n=Gb5xYa94zdUk8qUq\&q=85\&s=41bcd87c518454ab07a476b54a708d1d)

**5. Add the permission scopes**

Enables actions: Add Note To Incident, Create Incident, Create Schedule, Create Service, Create Team, Create User, Delete Schedule, Delete Service, Delete Team, Delete User, Get Escalation Policy, Get Incident, Get Incident Type, Get Schedule, Get Service, Get Team, Get Unified Group, Get Unified Role, Get Unified User, Get User, Get User License, Get Vendor, List Audit Records, List Escalation Policies, List Incident Log Entries, List Incident Notes, List Incident Types, List Incidents, List License Allocations, List Licenses, List On-Calls, List Priorities, List Schedules, List Services, List Teams, List Unified Groups, List Unified Resource Types, List Unified Resource Users, List Unified Roles, List Unified Users, List Users, List Vendors, Update Incident, Update Service, Update Team, Update User

Under **Permission Scope**, find each resource in the table and select its **Read Access** or **Write Access** checkbox. **Search Resource** filters the table, and **Total Resources Used** counts the resources selected so far.

<ul>
  <li>Select every scope the connector requests. When an app requests a scope it does not hold, PagerDuty issues a token carrying only the `openid` scope, and every API call then fails.</li>
</ul>

![The Permission Scope table with Read Access selected for Abilities, Audit Records and Escalation Policies.](https://mintcdn.com/stackone-60/Gb5xYa94zdUk8qUq/connectors/pagerduty/images/oauth2-setup-permission-scope.png?fit=max\&auto=format\&n=Gb5xYa94zdUk8qUq\&q=85\&s=1409112d8f9f223d24ca3d8b6f00ca53)

<ul>
  <li>
    abilities.read
  </li>

  <li>
    audit\_records.read
  </li>

  <li>
    escalation\_policies.read
  </li>

  <li>
    incident\_types.read
  </li>

  <li>
    incidents.read
  </li>

  <li>
    incidents.write
  </li>

  <li>
    licenses.read
  </li>

  <li>
    oncalls.read
  </li>

  <li>
    priorities.read
  </li>

  <li>
    schedules.read
  </li>

  <li>
    schedules.write
  </li>

  <li>
    services.read
  </li>

  <li>
    services.write
  </li>

  <li>
    teams.read
  </li>

  <li>
    teams.write
  </li>

  <li>
    users.read
  </li>

  <li>
    users.write
  </li>

  <li>
    vendors.read
  </li>

  <li>
    webhook\_subscriptions.write
  </li>
</ul>

**6. Copy the credentials**

Click **Register App**. The **OAuth 2.0 Client Information** dialog opens with the credentials.

<ul>
  <li>Copy the **Client ID** into your Connector Profile.</li>
  <li>Copy the **Client Secret** into your Connector Profile.</li>
  <li>This is the only time the client information can be viewed or downloaded. The Client Secret cannot be retrieved later, so store it securely before closing the dialog.</li>
  <li>Click **Continue**.</li>
</ul>

![The OAuth 2.0 Client Information dialog with the Copy to Clipboard buttons highlighted and the values hidden.](https://mintcdn.com/stackone-60/Gb5xYa94zdUk8qUq/connectors/pagerduty/images/oauth2-setup-client-information.png?fit=max\&auto=format\&n=Gb5xYa94zdUk8qUq\&q=85\&s=a49ef7bf7a1f2d67c5010c31953c124a)

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/pagerduty/guides/link-account/oauth-2-0.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.