> ## 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

> How to set up the PagerDuty connector, plus the actions and events that are available.

![PagerDuty](https://stackone-logos.com/api/pagerduty/filled/svg)

v1.5.0[See changelog](https://docs.stackone.com/connectors/pagerduty/changelog.md)

[50 actions](#actions) · [31 events](#events) · 2 auth methods

ITSM
Ticketing
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

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).

> [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/pagerduty/guides/connector-profile/api-key.md)
>
> Generate an API key from your PagerDuty account settings. Requires appropriate permissions based on the actions you need...

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/pagerduty/guides/connector-profile/oauth-2-0.md)
>
> Requires registering a PagerDuty App with Scoped OAuth functionality. The token acts as the user who signs in, limited t...

Optionally, configure receiving Events for PagerDuty into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/pagerduty/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [API Key · Link Account](https://docs.stackone.com/connectors/pagerduty/guides/link-account/api-key.md)

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/pagerduty/guides/link-account/oauth-2-0.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

API Key

OAuth 2.0

No auth methods found

Scopes

Select all
|
Clear

abilities.read

audit\_records.read

escalation\_policies.read

incident\_types.read

incidents.read

incidents.write

licenses.read

oncalls.read

priorities.read

schedules.read

schedules.write

services.read

services.write

teams.read

teams.write

users.read

users.write

vendors.read

No scopes found

50 actions

ActionDescriptionRequired scopes

List Audit Records`pagerduty_list_audit_records`

Retrieve audit trail of configuration changes and actions to track compliance, investigate changes, and perform security...

`audit_records.read`

List Escalation Policies`pagerduty_list_escalation_policies`

List all existing escalation policies

`escalation_policies.read`

Get Escalation Policy`pagerduty_get_escalation_policy`

Get information about an existing escalation policy

`escalation_policies.read`

Get Unified Credentials`pagerduty_unified_get_me`

Get the current PagerDuty connection's unified credentials and identity.

IAM Auth Test`pagerduty_auth_test`

Validate the current PagerDuty API key and return the raw, unmapped /users/me response (the authenticated principal user...

List Unified Groups`pagerduty_unified_list_groups`

List unified groups in PagerDuty.

`teams.read`

Get Unified Group`pagerduty_unified_get_group`

Get a unified PagerDuty group by ID.

`teams.read`

List Unified Organizations`pagerduty_unified_list_organizations`

List unified organizations in PagerDuty.

Get Unified Organization`pagerduty_unified_get_organization`

Get a unified PagerDuty organization by ID.

List Unified Resource Types`pagerduty_unified_list_resource_types`

List unified resource types in PagerDuty.

`abilities.read`

List Unified Resource Users`pagerduty_unified_list_resource_users`

List unified resource users in PagerDuty.

`teams.read`

List Unified Roles`pagerduty_unified_list_roles`

List unified roles in PagerDuty.

`abilities.read`

Get Unified Role`pagerduty_unified_get_role`

Get a unified PagerDuty role by ID.

`abilities.read`

List Unified Users`pagerduty_unified_list_users`

List unified users in PagerDuty.

`users.read`

Get Unified User`pagerduty_unified_get_user`

Get a unified PagerDuty user by ID.

`users.read`

List Incident Types`pagerduty_list_incident_types`

List available incident types

`incident_types.read`

Get Incident Type`pagerduty_get_incident_type`

Get detailed information about a single incident type

`incident_types.read`

List Incidents`pagerduty_list_incidents`

Retrieve a paginated list of incidents with filtering options by status, urgency, time range, service, or team.

`incidents.read`

Get Incident`pagerduty_get_incident`

Retrieve detailed information about a specific incident including timeline, responders, alerts, and notes.

`incidents.read`

Create Incident`pagerduty_create_incident`

Manually create a new incident through the API with specified title, service, and urgency.

`incidents.write`

Update Incident`pagerduty_update_incident`

Modify incident properties including title, service, urgency, priority, assignments, escalation policy, conference bridg...

`incidents.write`

Add Note To Incident`pagerduty_add_note_to_incident`

Add contextual notes or comments to an incident to document investigation findings, remediation steps, or team communica...

`incidents.write`

List Incident Notes`pagerduty_list_incident_notes`

Retrieve all notes associated with an incident for extracting communication history during postmortems or analysis.

`incidents.read`

List Incident Log Entries`pagerduty_list_incident_log_entries`

Retrieve the complete timeline of actions and changes for an incident to audit handling, generate reports, and analyze r...

`incidents.read`

List Licenses`pagerduty_list_licenses`

Retrieve all licenses available in the account to monitor license types and availability.

`licenses.read`

List License Allocations`pagerduty_list_license_allocations`

Retrieve all user license allocations to monitor license usage and identify unassigned licenses.

`licenses.read`

Get User License`pagerduty_get_user_license`

Retrieve the license allocated to a specific user to verify license assignment and type.

`licenses.read`

List Priorities`pagerduty_list_priorities`

Retrieve all incident priorities ordered by severity from most to least severe to populate priority dropdowns and valida...

`priorities.read`

List Schedules`pagerduty_list_schedules`

Retrieve all on-call schedules in the account to display rotations and audit schedule coverage.

`schedules.read`

Get Schedule`pagerduty_get_schedule`

Fetch detailed schedule information including layers and overrides to retrieve full configuration for analysis or clonin...

`schedules.read`

List On-Calls`pagerduty_list_on_calls`

Query who is currently on-call across schedules and escalation policies to display current information in dashboards or...

`oncalls.read`

Create Schedule`pagerduty_create_schedule`

Create a new on-call schedule with rotation layers to automate schedule creation during team onboarding.

`schedules.write`

Delete Schedule`pagerduty_delete_schedule`

Remove a schedule from the account to clean up unused schedules during reorganization.

`schedules.write`

List Services`pagerduty_list_services`

Retrieve all services in the account with filtering options to populate service directories, build catalogs, and audit c...

`services.read`

Get Service`pagerduty_get_service`

Fetch detailed configuration and metadata for a specific service including settings, integrations, and escalation polici...

`services.read`

Create Service`pagerduty_create_service`

Create a new service with escalation policy and settings to automate service provisioning during infrastructure deployme...

`services.write`

Update Service`pagerduty_update_service`

Modify service configuration, settings, or associations to update properties, change escalation policies, or enable feat...

`services.write`

Delete Service`pagerduty_delete_service`

Remove a service from the account to clean up deprecated services during decommissioning.

`services.write`

List Teams`pagerduty_list_teams`

Retrieve all teams in the account to organize users and services by team structure.

`teams.read`

Get Team`pagerduty_get_team`

Fetch detailed team information including members to retrieve team composition and associated resources.

`teams.read`

Create Team`pagerduty_create_team`

Create a new team to organize users and services by team structure within the organization.

`teams.write`

Update Team`pagerduty_update_team`

Modify team properties including name, description, or default role to update team structure.

`teams.write`

Delete Team`pagerduty_delete_team`

Remove a team from the account to clean up unused teams during organizational restructuring.

`teams.write`

List Users`pagerduty_list_users`

Retrieve all users in the account with filtering options to sync with HR systems, generate reports, and audit access.

`users.read`

Get User`pagerduty_get_user`

Fetch detailed information about a specific user including contact methods, notification rules, and roles.

`users.read`

Create User`pagerduty_create_user`

Add a new user to the account to automate user onboarding from HR systems or identity providers.

`users.write`

Update User`pagerduty_update_user`

Modify user properties, roles, or settings to update information, change roles, or modify notification preferences.

`users.write`

Delete User`pagerduty_delete_user`

Remove a user from the account to automate user offboarding during employee departures.

`users.write`

List Vendors`pagerduty_list_vendors`

Retrieve available integration vendors and types to discover supported monitoring tools and integration options.

`vendors.read`

Get Vendor`pagerduty_get_vendor`

Fetch detailed information about a specific vendor including integration capabilities and configuration options.

`vendors.read`

## Events

Tags

Select all
|
Clear

Incidents

Services

Webhooks

No tags found

31 events

EventDescriptionTags

Incident Triggered`pagerduty_webhook_incident_triggered`

Sent when an incident is newly created/triggered.

IncidentsWebhooks

Incident Acknowledged`pagerduty_webhook_incident_acknowledged`

Sent when an incident is acknowledged.

IncidentsWebhooks

Incident Unacknowledged`pagerduty_webhook_incident_unacknowledged`

Sent when an incident is unacknowledged.

IncidentsWebhooks

Incident Escalated`pagerduty_webhook_incident_escalated`

Sent when an incident has been escalated to another user in the same escalation level.

IncidentsWebhooks

Incident Reassigned`pagerduty_webhook_incident_reassigned`

Sent when an incident has been reassigned to another user.

IncidentsWebhooks

Incident Delegated`pagerduty_webhook_incident_delegated`

Sent when an incident has been reassigned to another escalation policy.

IncidentsWebhooks

Incident Resolved`pagerduty_webhook_incident_resolved`

Sent when an incident is resolved.

IncidentsWebhooks

Incident Reopened`pagerduty_webhook_incident_reopened`

Sent when an incident is reopened.

IncidentsWebhooks

Incident Priority Updated`pagerduty_webhook_incident_priority_updated`

Sent when the priority of an incident has changed.

IncidentsWebhooks

Incident Service Updated`pagerduty_webhook_incident_service_updated`

Sent when the service of an incident has changed.

IncidentsWebhooks

Incident Custom Field Values Updated`pagerduty_webhook_incident_custom_field_values_updated`

Sent when an incident's custom fields values are updated.

IncidentsWebhooks

Incident Annotated`pagerduty_webhook_incident_annotated`

Sent when a note is added to an incident.

IncidentsWebhooks

Incident Status Update Published`pagerduty_webhook_incident_status_update_published`

Sent when a status update is added to an incident.

IncidentsWebhooks

Incident Conference Bridge Updated`pagerduty_webhook_incident_conference_bridge_updated`

Sent when an incident's conference bridge number and/or conference bridge url is updated.

IncidentsWebhooks

Incident Responder Added`pagerduty_webhook_incident_responder_added`

Sent when a responder has been added to an incident.

IncidentsWebhooks

Incident Responder Replied`pagerduty_webhook_incident_responder_replied`

Sent when a responder replies to a request.

IncidentsWebhooks

Incident Role Assigned`pagerduty_webhook_incident_role_assigned`

Sent when an incident role is assigned or unassigned.

IncidentsWebhooks

Incident Task Created`pagerduty_webhook_incident_task_created`

Sent when an incident task is created.

IncidentsWebhooks

Incident Task Updated`pagerduty_webhook_incident_task_updated`

Sent when an incident task is updated.

IncidentsWebhooks

Incident Task Completed`pagerduty_webhook_incident_task_completed`

Sent when an incident task is completed.

IncidentsWebhooks

Incident Action Invocation Created`pagerduty_webhook_incident_action_invocation_created`

Sent when an incident action invocation is created.

IncidentsWebhooks

Incident Action Invocation Updated`pagerduty_webhook_incident_action_invocation_updated`

Sent when an incident action invocation is updated.

IncidentsWebhooks

Incident Action Invocation Terminated`pagerduty_webhook_incident_action_invocation_terminated`

Sent when an incident action invocation is terminated.

IncidentsWebhooks

Incident Workflow Started`pagerduty_webhook_incident_workflow_started`

Sent when an incident workflow starts.

IncidentsWebhooks

Incident Workflow Completed`pagerduty_webhook_incident_workflow_completed`

Sent when an incident workflow completes.

IncidentsWebhooks

Service Created`pagerduty_webhook_service_created`

Sent when a service is created.

ServicesWebhooks

Service Updated`pagerduty_webhook_service_updated`

Sent when a service is updated.

ServicesWebhooks

Service Deleted`pagerduty_webhook_service_deleted`

Sent when a service is deleted.

ServicesWebhooks

Service Custom Field Values Updated`pagerduty_webhook_service_custom_field_values_updated`

Sent when an service's custom fields values are updated.

ServicesWebhooks

Incident Type Updated`pagerduty_webhook_incident_incident_type_updated`

Sent when an incident's type is changed.

IncidentsWebhooks

Scribe Summary Created`pagerduty_webhook_scribe_summary_created`

Sent when a Scribe summary is created.

IncidentsWebhooks


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