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

# Pagerduty

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (OAuth) | ✅ |
> | Credentials auto-refresh | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | ✅ |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

### Others

| Function name | Description | Type |
| - | - | - |
| `add-incident-status-update-subscribers` | Subscribe users or teams to status updates for a PagerDuty incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-team-escalation-policy` | Associate an escalation policy with a team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-team-member` | Add a user to a team with a given role. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `assign-entity-tags` | Add and/or remove tags on a user, team, or escalation policy in one call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `bulk-update-incident-alerts` | Manage or unmanage multiple alerts on an incident in a single call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `bulk-update-incidents` | Acknowledge, resolve, reassign, or escalate multiple incidents in a single call. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `count-incidents` | Get a count of incidents matching a filter, without fetching the incident records themselves. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-business-service` | Create a business service. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-escalation-policy` | Create an escalation policy with one or more escalation rules. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident-note` | Add a note to an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident-responder-request` | Request additional responders (users, teams, or escalation policies) join an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident-status-update` | Post a human-readable status update on an incident (visible to subscribers). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-incident` | Create a new incident against a service. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-maintenance-window` | Create a maintenance window suppressing alerts on one or more services for a time range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-schedule-overrides` | Create one or more overrides on a schedule (temporarily replace who is on-call for a time window). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-schedule` | Create an on-call schedule with one or more layers. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-service-integration` | Create a new integration (event source) on a service. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-service` | Create a service under an escalation policy. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-tag` | Create a tag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-team` | Create a team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-user-contact-method` | Add a new contact method to a user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-user-notification-rule` | Add a new notification rule to a user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-user` | Create a new user on the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-business-service` | Delete a business service. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-escalation-policy` | Delete an escalation policy. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-incident-note` | Delete a note from an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-maintenance-window` | Delete or end a maintenance window. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-schedule-override` | Delete a single override from a schedule. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-schedule` | Delete a schedule. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-service` | Delete a service. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-tag` | Delete a tag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-team` | Delete a team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-user-notification-rule` | Delete a notification rule from a user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-user` | Delete a user from the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-business-service` | Retrieve a single business service. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-current-user` | Retrieve the user associated with the current API credentials. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-entity-tags` | List the tags assigned to a user, team, or escalation policy. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-incident-alert` | Retrieve a single alert on an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-incident` | Retrieve a single incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-log-entry` | Retrieve a single log entry. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-maintenance-window` | Retrieve a single maintenance window. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-schedule` | Retrieve a single schedule, including its layers and assigned users. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-service-integration` | Retrieve a single integration on a service. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-service` | Retrieve a single service, including its embedded escalation policy and integrations. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-tag` | Retrieve a single tag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-tagged-entities` | List the users, teams, or escalation policies that carry a given tag. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-team` | Retrieve a single team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-contact-method` | Retrieve a single contact method for a user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user-notification-rule` | Retrieve a single notification rule for a user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-user` | Retrieve a single user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-vendor` | Retrieve a single vendor. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-business-services` | List business services (higher-level business-facing services distinct from technical Services). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-escalation-policies` | List escalation policies, optionally filtered by user or team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-alerts` | List the alerts attached to an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-log-entries` | List the timeline of log entries (state changes) for an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-notes` | List notes (annotations) on an incident | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incident-status-update-subscribers` | List users/teams subscribed to status updates for an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-incidents` | List incidents, optionally filtered by service, team, user, status, urgency, or date range. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-log-entries` | List the account-wide log entries feed (every incident/alert state-change event across the account). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-maintenance-windows` | List maintenance windows, optionally filtered by service or team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-oncalls` | List who is currently on-call across every escalation policy and schedule on the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-priorities` | List the account's configured incident priority levels (P1-P5). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-schedule-overrides` | List overrides on a schedule within a time window. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-schedule-users` | List the users who are on-call according to a schedule within a time window. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-schedules` | List on-call schedules (legacy/v2 schedule model). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-services` | List services, optionally filtered by team or name. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-tags` | List tags on the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-team-members` | List the members of a team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-teams` | List teams on the account. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-user-contact-methods` | List a user's contact methods (email, SMS, phone, push channels). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-user-notification-rules` | List a user's notification rules (how/when they get notified of assignments). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-users` | List users on the account, optionally filtered by team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-vendors` | List the global catalog of integration vendor types | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `merge-incident` | Merge one or more source incidents into a destination incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `preview-schedule` | Preview the computed on-call entries for a schedule definition without saving it. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-incident-status-update-subscriber` | Unsubscribe a single user or team from status updates for an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-team-escalation-policy` | Remove an escalation policy's association with a team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-team-member` | Remove a user from a team. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `snooze-incident` | Snooze an incident for a given duration (re-triggers it later if not resolved). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-business-service` | Update a PagerDuty business service. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-escalation-policy` | Update an escalation policy's name, description, or rules. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-incident-alert` | Manage or unmanage (resolve/trigger) a single alert on an incident. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-incident-note` | Update the content of an existing incident note. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-incident` | Update an incident: acknowledge, resolve, reassign, escalate, retitle, or change urgency/priority | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-maintenance-window` | Update a maintenance window's time range, description, or scoped services. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-schedule` | Update a schedule's name, time zone, or layers. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-service-integration` | Update an existing integration on a service | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-service` | Update an existing PagerDuty service's fields, including reassigning its escalation policy. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-team` | Update a PagerDuty team name, description, or default role. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-user-notification-rule` | Update an existing notification rule. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-user` | Update a user's fields (name, job title, role, time zone, etc). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `business-services` | Sync business services. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `incidents` | Sync incidents. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `log-entries` | Sync the account-wide log entries feed (every incident/alert state-change event across the account). | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `maintenance-windows` | Sync maintenance windows. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `oncalls` | Sync the current on-call snapshot across every escalation policy and schedule on the account. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `priorities` | Sync the account's configured incident priority levels. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `schedules` | Sync on-call schedules (legacy/v2 schedule model), including each schedule's layers and assigned users | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `services` | Sync PagerDuty services, including each service's embedded escalation-policy reference and integrations array. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `tags` | Sync tags | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `teams` | Sync teams. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `users` | Sync PagerDuty users. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `vendors` | Sync the global integration-vendor-type catalog. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |

## Setup guide

*No setup guide yet.*

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/pagerduty.mdx)

## Useful links

* [How to register an Application](https://developer.pagerduty.com/docs/dd91fbd09a1a1-register-an-app)
* [OAuth-related docs](https://developer.pagerduty.com/docs/dd91fbd09a1a1-register-an-app)
* [API](https://developer.pagerduty.com/docs/ZG9jOjExMDI5NTUw-rest-api-v2-overview)
* [Web API docs (their REST API)](https://developer.pagerduty.com/api-reference/e65c5833eeb07-pager-duty-api)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/pagerduty.mdx)

## API gotchas

* Scopes should be either `read` or `write`.

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/pagerduty.mdx)


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