## PagerDuty integration

PagerDuty is a digital operations management platform for incident response, on-call scheduling, and real-time alerting. The PagerDuty integration with Frontegg allows your application to access and manage incidents, services, schedules, escalation policies, on-calls, users, teams, and webhook subscriptions on behalf of your users.

Prerequisites
- A PagerDuty account with admin access
- Access to the App Registration page in your PagerDuty subdomain


### Connect PagerDuty

#### Step 1: Open the App Registration page

Sign in to your PagerDuty account and navigate to **Integrations** → **App Registration**, or open `https://YOUR_SUBDOMAIN.pagerduty.com/developer/applications` directly. The page lists all apps registered under your account and provides a **New App** button.

![PagerDuty App Registration page with New App button highlighted](/assets/pagerduty-1.1d5781026cb7afaaba9b3273e760b82ea57150e636924259cbef2bcaffa59c4b.1ce25488.png)

#### Step 2: Create a new app

Click **New App**. Enter the following information:

- **Name**: `Frontegg Integration`
- **Description**: A short description of the integration


Under **Functionality**, check **OAuth 2.0** to enable REST API access via OAuth, then click **Next**.

![PagerDuty New App form with OAuth 2.0 functionality selected](/assets/pagerduty-2.c7e63a511f09b5e5419747c74a17dddbd3a9c42dc1a633eed3119624758e9c38.1ce25488.png)

#### Step 3: Choose Scoped OAuth and add redirect URLs

On the **Configure OAuth 2.0** step, leave **Scoped OAuth** selected. Scoped OAuth provides granular read and write access to PagerDuty resources and matches the scopes used by Frontegg.

Under **Redirect URL**, click **Add Redirect URL** and enter the following URIs:

- `https://YOUR_MCP_GATEWAY_URL/integration-callback`


If only one redirect URL is allowed, use the first one.

![PagerDuty OAuth configuration with Scoped OAuth selected and Frontegg redirect URLs added](/assets/pagerduty-3.bc1abacecdda297cceeebcd18c4ee673af4bd129da6138e784ce235ce3cee39c.1ce25488.png)

#### Step 4: Select permission scopes

Under **Permission Scope**, select **Read Access** and **Write Access** for the following resources:

| Resource | Scopes |
|  --- | --- |
| Incidents | `incidents.read`, `incidents.write` |
| Services | `services.read`, `services.write` |
| Schedules | `schedules.read`, `schedules.write` |
| Escalation Policies | `escalation_policies.read`, `escalation_policies.write` |
| Oncalls | `oncalls.read` |
| Users | `users.read`, `users.write` |
| Teams | `teams.read`, `teams.write` |
| Webhook Subscriptions | `webhook_subscriptions.read`, `webhook_subscriptions.write` |


Minimum required scopes
For basic incident management, you need at least `incidents.read`, `incidents.write`, and `services.read`. Add more scopes only if your integration needs them.

![PagerDuty Permission Scope table with required resources checked](/assets/pagerduty-4.ee41184275e3ebc7fa6b0d8581c86e6305925de4002aaee6d487dbc7b8bbb606.1ce25488.png)

#### Step 5: Verify selected scopes

Scroll down to the **Selected Permission Scope** section to confirm that all required scopes are listed in the read-only field. The full list should match the resources selected above.

![PagerDuty Selected Permission Scope textbox showing all 15 selected scopes](/assets/pagerduty-5.7af7f1cba8cfc5caea9d6d853dc870be612de51773451addd88c14086baee033.1ce25488.png)

#### Step 6: Register the app and copy credentials

Click **Register App**. PagerDuty displays the **OAuth 2.0 Client Information** dialog with your **Client ID** and **Client Secret**. Copy both values and store them in a safe place.

One-time display
PagerDuty shows the Client Secret only once. If you lose it, you must generate a new one from the app's settings.

![PagerDuty OAuth 2.0 Client Information dialog with Client ID and Client Secret](/assets/pagerduty-6.b3e063acbc505b2095842868c505aa5d9290ec2e830d5466eb48dde87a50c016.1ce25488.png)

### Configure the Frontegg portal

Once you have obtained your **Client ID** and **Client Secret** from the steps above, enter them in the integration configuration page of the Frontegg portal:

1. Open the **Frontegg portal** and navigate to your environment → **Integrations** → **PagerDuty**.
2. Enter the **Client ID** and **Client Secret** in the corresponding fields.
3. Select the required **scopes**.
4. Click **Save**.


Keep your credentials secure
Never share or commit your Client Secret to version control.

### Additional resources

- [PagerDuty Developer Documentation](https://developer.pagerduty.com/docs/get-started/getting-started/)
- [PagerDuty REST API Reference](https://developer.pagerduty.com/api-reference/)
- [PagerDuty OAuth 2.0 functionality](https://developer.pagerduty.com/docs/f59fdbd94ceab-o-auth-functionality)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)