![pagerduty icon](/docs/img/components/icons/60/cGFnZXJkdXR5.png) # PagerDuty Connector key: pagerduty[Source](https://github.com/prismatic-io/components/tree/main/components/pagerduty)[API Docs](https://developer.pagerduty.com/api-reference/e65c5833eeb07-pager-duty-api)[API Changelog](https://developer.pagerduty.com/api-reference/f1a95bb9397ba-changelog)[Connector Changelog](#changelog) ## Description[​](#description "Direct link to Description") [PagerDuty](https://www.pagerduty.com/) is an industry leading incident management tool. This component allows the creation and management of Incidents, events, and more. #### API Documentation[​](#api-documentation "Direct link to API Documentation") This component was built using the [PagerDuty REST API](https://developer.pagerduty.com/api-reference/e65c5833eeb07-pager-duty-api). ## Connections[​](#connections "Direct link to Connections") ### API Key[​](#pagerduty-api-key "Direct link to API Key") **key: pagerduty-api-key** To create a PagerDuty API Key connection, generate a REST API key from the PagerDuty account. #### Prerequisites[​](#prerequisites "Direct link to Prerequisites") * A PagerDuty account with administrative permissions to create API access keys * Access to the [PagerDuty web app](https://app.pagerduty.com/) #### Setup Steps[​](#setup-steps "Direct link to Setup Steps") 1. [Log in to PagerDuty](https://app.pagerduty.com/) and navigate to [Integrations | API Access Keys](https://support.pagerduty.com/main/docs/api-access-keys#section-generate-a-user-token-rest-api-key). 2. Click **Create New API Key**. 3. Enter a description for the API key. Check **Read-only API Key** if read-only behavior is desired. 4. Click **Create Key**. 5. Copy the provided API Key for use in the connection configuration. #### Configure the Connection[​](#configure-the-connection "Direct link to Configure the Connection") * Create a connection of type **API Key**. * Enter the **Token** copied from PagerDuty. This is the API token used to authenticate requests. | Input | Notes | Example | | ----- | ------------------------------------------------------ | ------- | | Token | The PagerDuty API token used to authenticate requests. | | ### OAuth 2.0[​](#pagerduty-oauth "Direct link to OAuth 2.0") **key: pagerduty-oauth** To create a PagerDuty OAuth 2.0 connection, register an app in PagerDuty to obtain a Client ID and Client Secret. For background, refer to [OAuth 2.0 for PagerDuty](https://developer.pagerduty.com/docs/b2a19cce2867a-classic-user-o-auth). #### Prerequisites[​](#prerequisites-1 "Direct link to Prerequisites") * A PagerDuty account with permissions to register apps * Access to the [PagerDuty App Registration page](https://developer.pagerduty.com/docs/dd91fbd09a1a1-register-an-app) #### Setup Steps[​](#setup-steps-1 "Direct link to Setup Steps") 1. [Log in to PagerDuty](https://app.pagerduty.com/) and navigate to [Integrations | App Registration](https://developer.pagerduty.com/docs/dd91fbd09a1a1-register-an-app). 2. From the top menu, select **Integrations**. 3. Select **App Registration** from the menu to navigate to the **My Apps** page. 4. On the **My Apps** page, select **New App**. Enter a name for the app and a brief description. 5. Check the box next to **OAuth 2.0** and/or **Events Integration**. 6. For Authorization select one of the following: 1. [**Scoped OAuth**](https://developer.pagerduty.com/docs/f59fdbd94ceab-o-auth-functionality#scoped-oauth) - New OAuth client that allows granular read or write access to PagerDuty resources like incidents, services, users, with other benefits. 1. Use the table to select Read or Write access to each Resource the integration requires. 2. [**Classic User OAuth**](https://developer.pagerduty.com/docs/f59fdbd94ceab-o-auth-functionality#scoped-oauth) - Existing OAuth client that allows apps to act on behalf of users, with read or write to all PagerDuty resources. 1. Assign a permission scope of **Read** or **Read and Write**. 7. In the **Redirect URL** field, enter `https://oauth2.prismatic.io/callback`. 8. Select **Register App**. 9. Copy and save the Client ID and Client Secret for use in the connection configuration. #### Configure the Connection[​](#configure-the-connection-1 "Direct link to Configure the Connection") * Create a connection of type **OAuth 2.0**. * Enter the **Scopes** granted to the app. Use `write` for read/write access or `read` for read-only access to all resources (Classic User OAuth). * Enter the **Client ID** copied from the PagerDuty OAuth application. * Enter the **Client Secret** copied from the PagerDuty OAuth application. | Input | Notes | Example | | ------------- | --------------------------------------------------------------------------------- | ----------------------------------------------- | | Authorize URL | The OAuth 2.0 authorization URL for the PagerDuty code grant. | https\://identity.pagerduty.com/oauth/authorize | | Client ID | The client ID of the PagerDuty OAuth application. | | | Client Secret | The client secret of the PagerDuty OAuth application. | | | Scopes | The Classic User OAuth scope granting read or read/write access to all resources. | write | | Token URL | The OAuth 2.0 token URL for the PagerDuty code grant. | https\://identity.pagerduty.com/oauth/token | ## Triggers[​](#triggers "Direct link to Triggers") ### Incident Webhook[​](#incidentstrigger "Direct link to Incident Webhook") Receive incident webhook notifications from PagerDuty when a selected incident event occurs. | **key: incidentsTrigger** | Input | Notes | Example | | ------------------- | ------------------------------------------------------- | ------------------------------ | | Connection | The PagerDuty connection to use. | | | Incident Events | The incident events that trigger the webhook. | | | Filter ID | The unique identifier of the object used as the filter. | sampleFilterId | | Filter Type | The type of object used as the filter. | | | Webhook Description | A descriptive label used to identify the webhook. | This Is An Example Description | The Incidents Trigger receives [webhook notifications](https://support.pagerduty.com/main/docs/webhooks) from PagerDuty when incident events occur. This trigger automatically manages webhook subscriptions — the entire lifecycle is handled without manual configuration in the PagerDuty dashboard. #### How It Works[​](#how-it-works "Direct link to How It Works") When this trigger is used in a flow: * **On Instance Deploy**: The trigger automatically creates a V3 webhook subscription in PagerDuty pointing to the instance's unique webhook URL. The subscription is configured with the selected incident events, a filter (by account, service, or team), and a description. * **On Instance Deletion**: The trigger automatically removes all webhook subscriptions associated with the instance's webhook URLs from PagerDuty. #### Configuration[​](#configuration "Direct link to Configuration") Configure the following inputs: * **Incident Events**: Select which incident events the webhook subscription should monitor. Multiple events can be selected. * **Webhook Description**: A description for the webhook subscription created in PagerDuty. * **Filter ID**: The ID of the PagerDuty object (account, service, or team) used to scope the webhook subscription. * **Filter Type**: The type of object used as the filter — **Account**, **Service**, or **Team**. #### Event Types[​](#event-types "Direct link to Event Types") Available Incident Events (17) | Event | Description | | ------------------------------------ | -------------------------------------------- | | `incident.acknowledged` | An incident is acknowledged | | `incident.annotated` | A note is added to an incident | | `incident.conference_bridge.updated` | An incident's conference bridge is updated | | `incident.delegated` | An incident is delegated | | `incident.escalated` | An incident is escalated | | `incident.priority_updated` | An incident's priority is updated | | `incident.reassigned` | An incident is reassigned | | `incident.reopened` | An incident is reopened | | `incident.resolved` | An incident is resolved | | `incident.responder.added` | A responder is added to an incident | | `incident.responder.replied` | A responder replies to an incident | | `incident.service_updated` | An incident's service is updated | | `incident.status_update_published` | A status update is published for an incident | | `incident.triggered` | An incident is triggered | | `incident.unacknowledged` | An incident is unacknowledged | | `incident.workflow.started` | An incident workflow is started | | `incident.workflow.completed` | An incident workflow is completed | Refer to the [PagerDuty webhooks documentation](https://support.pagerduty.com/main/docs/webhooks) for the complete and up-to-date list of event types. #### Returned Data[​](#returned-data "Direct link to Returned Data") Example Payload ```json { "event": { "id": "01DEN0M0L0OCDNR0CDEVP4SRGH", "event_type": "incident.triggered", "resource_type": "incident", "occurred_at": "2024-01-15T10:30:00.000Z", "data": { "id": "Q1P5SQEISWZ3K4", "type": "incident", "title": "Server is on fire", "status": "triggered", "urgency": "high", "service": { "id": "PF9KMXH", "type": "service_reference", "summary": "Production API" } } } } ``` Example Payload for Incident Webhook[⤓](https://prismatic.io/docs/example-payloads/pagerduty/triggers/incidentsTrigger.json "Download example payload") Loading… *** ### New Incidents[​](#pollchangestrigger "Direct link to New Incidents") Fetches incidents created since the last execution on a recurring schedule. | **key: pollChangesTrigger** | Input | Notes | Example | | ------------------ | ----------------------------------------------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Show New Incidents | When enabled, newly created incidents will be included in the trigger output. | true | The New Incidents polling trigger fetches PagerDuty incidents created since the last execution on a recurring schedule. Unlike the webhook-based triggers, this trigger does not require any external subscription — the integration polls the PagerDuty REST API directly. #### How It Works[​](#how-it-works-1 "Direct link to How It Works") * On each scheduled execution, the trigger calls the PagerDuty REST API to retrieve incidents created since the timestamp of the previous run. * The last poll timestamp is persisted in the trigger's polling state and updated after every execution. * When no new incidents are returned, the trigger signals `polledNoChanges` so the flow does not execute downstream steps. #### Returned Data[​](#returned-data-1 "Direct link to Returned Data") Example Payload ```json { "body": { "data": { "created": [ { "id": "Q1P5SQEISWZ3K4", "type": "incident", "summary": "[#1234] Server is on fire", "status": "triggered", "urgency": "high", "created_at": "2024-01-15T10:30:00Z", "service": { "id": "PF9KMXH", "type": "service_reference", "summary": "Production API" } } ], "updated": [] } } } ``` Fields shown are representative. The full response object includes additional properties. Example Payload for New Incidents[⤓](https://prismatic.io/docs/example-payloads/pagerduty/triggers/pollChangesTrigger.json "Download example payload") Loading… *** ### Service Webhook[​](#servicetrigger "Direct link to Service Webhook") Receive service webhook notifications from PagerDuty when a selected service event occurs. | **key: serviceTrigger** | Input | Notes | Example | | ------------------- | ------------------------------------------------------- | ------------------------------ | | Connection | The PagerDuty connection to use. | | | Service Events | The service events that trigger the webhook. | | | Filter ID | The unique identifier of the object used as the filter. | sampleFilterId | | Filter Type | The type of object used as the filter. | | | Webhook Description | A descriptive label used to identify the webhook. | This Is An Example Description | The Service Trigger receives [webhook notifications](https://support.pagerduty.com/main/docs/webhooks) from PagerDuty when service events occur. This trigger works identically to the **Incidents Trigger**, automatically managing webhook subscriptions throughout the instance lifecycle. See [Incidents Trigger](#incidentstrigger) for complete documentation on how lifecycle management, configuration, and webhook subscriptions work. #### Configuration[​](#configuration-1 "Direct link to Configuration") Configure the following inputs: * **Service Events**: Select which service events the webhook subscription should monitor. * **Webhook Description**: A description for the webhook subscription created in PagerDuty. * **Filter ID**: The ID of the PagerDuty object (account, service, or team) used to scope the webhook subscription. * **Filter Type**: The type of object used as the filter — **Account**, **Service**, or **Team**. #### Event Types[​](#event-types-1 "Direct link to Event Types") Available Service Events (3) | Event | Description | | ----------------- | -------------------- | | `service.created` | A service is created | | `service.deleted` | A service is deleted | | `service.updated` | A service is updated | Refer to the [PagerDuty webhooks documentation](https://support.pagerduty.com/main/docs/webhooks) for the complete and up-to-date list of event types. Example Payload for Service Webhook[⤓](https://prismatic.io/docs/example-payloads/pagerduty/triggers/serviceTrigger.json "Download example payload") Loading… *** ## Data Sources[​](#data-sources "Direct link to Data Sources") ### Select Incident[​](#selectincident "Direct link to Select Incident") Retrieve and select an incident. | **key: selectIncident** | **type: picklist** | Input | Notes | Example | | ---------- | -------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | *** ### Select Service[​](#selectservice "Direct link to Select Service") Retrieve and select a service. | **key: selectService** | **type: picklist** | Input | Notes | Example | | ---------- | -------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | *** ### Select Template[​](#selecttemplate "Direct link to Select Template") Retrieve and select a template. | **key: selectTemplate** | **type: picklist** | Input | Notes | Example | | ---------- | -------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | *** ### Select User[​](#selectuser "Direct link to Select User") Retrieve and select a user. | **key: selectUser** | **type: picklist** | Input | Notes | Example | | ---------- | -------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | *** ## Actions[​](#actions "Direct link to Actions") ### Create Incident[​](#createincident "Direct link to Create Incident") Create a new incident. | **key: createIncident** | Input | Notes | Example | | ---------- | ------------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | Incident | The JSON object body describing the incident to create. | See Example | Example Payload for Create Incident[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/createIncident.json "Download example payload") Loading… *** ### Create Incident Note[​](#createincidentnote "Direct link to Create Incident Note") Create a note on an incident. | **key: createIncidentNote** | Input | Notes | Example | | ----------- | ---------------------------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | Incident ID | The unique identifier for the incident. | PT4KHLK | | Note | The JSON object containing the note content to attach to the incident. | See Example | Example Payload for Create Incident Note[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/createIncidentNote.json "Download example payload") Loading… *** ### Create Service[​](#createservice "Direct link to Create Service") Create a new service. | **key: createService** | Input | Notes | Example | | ---------- | ------------------------------------------------------ | ------- | | Connection | The PagerDuty connection to use. | | | Service | The JSON object body describing the service to create. | | Example Payload for Create Service[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/createService.json "Download example payload") Loading… *** ### Create Template[​](#createtemplate "Direct link to Create Template") Create a new template. | **key: createTemplate** | Input | Notes | Example | | --------------- | ------------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | Template Object | The JSON object body describing the template to create. | See Example | Example Payload for Create Template[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/createTemplate.json "Download example payload") Loading… *** ### Create User[​](#createuser "Direct link to Create User") Create a new user. | **key: createUser** | Input | Notes | Example | | ---------- | --------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | User | The JSON object body describing the user to create. | See Example | Example Payload for Create User[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/createUser.json "Download example payload") Loading… *** ### Create Webhook Subscription[​](#createwebhooksubscription "Direct link to Create Webhook Subscription") Create a new webhook subscription. | **key: createWebhookSubscription** | Input | Notes | Example | | -------------------- | ------------------------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | Webhook Subscription | The JSON object body describing the webhook subscription to create. | See Example | Example Payload for Create Webhook Subscription[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/createWebhookSubscription.json "Download example payload") Loading… *** ### Delete All Instance Webhooks[​](#deleteallinstancewebhooks "Direct link to Delete All Instance Webhooks") Delete all webhook subscriptions associated with this instance. | **key: deleteAllInstanceWebhooks** | Input | Notes | Example | | ---------- | -------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | *** ### Delete Service[​](#deleteservice "Direct link to Delete Service") Delete a service by ID. | **key: deleteService** | Input | Notes | Example | | ---------- | -------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Service ID | The unique identifier for the service. | PIJ90N7 | Example Payload for Delete Service[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/deleteService.json "Download example payload") Loading… *** ### Delete Template[​](#deletetemplate "Direct link to Delete Template") Delete a template by ID. | **key: deleteTemplate** | Input | Notes | Example | | ----------- | --------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Template ID | The unique identifier for the template. | PBZUP2B | Example Payload for Delete Template[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/deleteTemplate.json "Download example payload") Loading… *** ### Delete User[​](#deleteuser "Direct link to Delete User") Delete a user by ID. | **key: deleteUser** | Input | Notes | Example | | ---------- | ----------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | User ID | The unique identifier for the user. | PXPGF42 | Example Payload for Delete User[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/deleteUser.json "Download example payload") Loading… *** ### Delete Webhook Subscription[​](#deletewebhooksubscription "Direct link to Delete Webhook Subscription") Delete a webhook subscription by ID. | **key: deleteWebhookSubscription** | Input | Notes | Example | | ---------- | -------------------------------------- | --------------- | | Connection | The PagerDuty connection to use. | | | Webhook ID | The unique identifier for the webhook. | sampleWebhookId | Example Payload for Delete Webhook Subscription[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/deleteWebhookSubscription.json "Download example payload") Loading… *** ### Enable Webhook Subscription[​](#enablewebhooksubscription "Direct link to Enable Webhook Subscription") Enable a disabled webhook subscription. | **key: enableWebhookSubscription** | Input | Notes | Example | | ---------- | -------------------------------------- | --------------- | | Connection | The PagerDuty connection to use. | | | Webhook ID | The unique identifier for the webhook. | sampleWebhookId | Example Payload for Enable Webhook Subscription[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/enableWebhookSubscription.json "Download example payload") Loading… *** ### Get Change Event[​](#getchangeevent "Direct link to Get Change Event") Retrieve a change event by ID. | **key: getChangeEvent** | Input | Notes | Example | | ---------- | ------------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Event ID | The unique identifier for the change event. | 12 | Example Payload for Get Change Event[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/getChangeEvent.json "Download example payload") Loading… *** ### Get Incident[​](#getincident "Direct link to Get Incident") Retrieve an incident by ID. | **key: getIncident** | Input | Notes | Example | | ----------- | -------------------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Incident ID | The unique identifier for the incident. | PT4KHLK | | Include | The additional details to include in the response. | | Example Payload for Get Incident[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/getIncident.json "Download example payload") Loading… *** ### Get Incident Alert[​](#getincidentalert "Direct link to Get Incident Alert") Retrieve a single alert from an incident. | **key: getIncidentAlert** | Input | Notes | Example | | ----------------- | --------------------------------------------- | ------- | | Incident Alert ID | The unique identifier for the incident alert. | PT4KHLK | | Connection | The PagerDuty connection to use. | | | Incident ID | The unique identifier for the incident. | PT4KHLK | Example Payload for Get Incident Alert[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/getIncidentAlert.json "Download example payload") Loading… *** ### Get Service[​](#getservice "Direct link to Get Service") Retrieve a service by ID. | **key: getService** | Input | Notes | Example | | ---------- | -------------------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Service ID | The unique identifier for the service. | PIJ90N7 | | Include | The additional details to include in the response. | | Example Payload for Get Service[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/getService.json "Download example payload") Loading… *** ### Get Template[​](#gettemplate "Direct link to Get Template") Retrieve a template by ID. | **key: getTemplate** | Input | Notes | Example | | ----------- | --------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Template ID | The unique identifier for the template. | PBZUP2B | Example Payload for Get Template[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/getTemplate.json "Download example payload") Loading… *** ### Get User[​](#getuser "Direct link to Get User") Retrieve a user by ID. | **key: getUser** | Input | Notes | Example | | ---------- | ------------------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | User ID | The unique identifier for the user. | PXPGF42 | | Include | The additional models to include in the response. | | Example Payload for Get User[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/getUser.json "Download example payload") Loading… *** ### Get Webhook Subscription[​](#getwebhooksubscription "Direct link to Get Webhook Subscription") Retrieve a webhook subscription by ID. | **key: getWebhookSubscription** | Input | Notes | Example | | ---------- | -------------------------------------- | --------------- | | Connection | The PagerDuty connection to use. | | | Webhook ID | The unique identifier for the webhook. | sampleWebhookId | Example Payload for Get Webhook Subscription[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/getWebhookSubscription.json "Download example payload") Loading… *** ### List Change Events[​](#listchangeevents "Direct link to List Change Events") List change events with optional filters. | **key: listChangeEvents** | Input | Notes | Example | | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | Connection | The PagerDuty connection to use. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Integration IDs | The unique identifiers of the integrations to filter results by. | PEYSGVF | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Since | The start of the date range over which to search, as a UTC ISO 8601 datetime string. | 2020-07-17T07:42:58Z | | Team IDs | The unique identifiers of the teams to filter results by. | PEYSGVF | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | | Until | The end of the date range over which to search, as a UTC ISO 8601 datetime string. | 2020-07-17T07:42:58Z | Example Payload for List Change Events[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listChangeEvents.json "Download example payload") Loading… *** ### List Incident Alerts[​](#listincidentalerts "Direct link to List Incident Alerts") List alerts for an incident. | **key: listIncidentAlerts** | Input | Notes | Example | | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | | Alert Key | The de-duplication key used to prevent duplicate alerts from being created. | baf7cf21b1da41b4b0221008339ff357 | | Connection | The PagerDuty connection to use. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Incident ID | The unique identifier for the incident. | PT4KHLK | | Include | The additional details to include in the response. | | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Sort By | The field and direction used to sort results. Field options: created\_at, resolved\_at. Direction: asc or desc. | | | Statuses | The statuses to filter incidents by. | | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | Example Payload for List Incident Alerts[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listIncidentAlerts.json "Download example payload") Loading… *** ### List Incident Notes[​](#listincidentnotes "Direct link to List Incident Notes") List notes for an incident. | **key: listIncidentNotes** | Input | Notes | Example | | ----------- | --------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Incident ID | The unique identifier for the incident. | PT4KHLK | Example Payload for List Incident Notes[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listIncidentNotes.json "Download example payload") Loading… *** ### List Incidents[​](#listincidents "Direct link to List Incidents") List incidents with optional filters. | **key: listIncidents** | Input | Notes | Example | | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | | Connection | The PagerDuty connection to use. | | | Date Range | When set to 'all', the since and until parameters and defaults are ignored. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Incident Key | The de-duplication key used to prevent duplicate incidents from being created. | baf7cf21b1da41b4b0221008339ff357 | | Include | The additional details to include in the response. | | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Service IDs | The unique identifiers of the services to filter incidents by. Only incidents associated with the listed services are returned. | PIJ90N7 | | Since | The start of the date range over which to search, as a UTC ISO 8601 datetime string. | 2020-07-17T07:42:58Z | | Sort By | The field and direction used to sort results. Field options: incident\_number, created\_at, resolved\_at, urgency. Direction: asc or desc. Example: 'incident\_number:desc'. | incident\_number:desc | | Statuses | The statuses to filter incidents by. | | | Team IDs | The unique identifiers of the teams to filter results by. | PEYSGVF | | Time Zone | The TZInfo-formatted time zone in which results are rendered. Example: 'America/Los\_Angeles'. | America/Los\_Angeles | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | | Until | The end of the date range over which to search, as a UTC ISO 8601 datetime string. | 2020-07-17T07:42:58Z | | Urgencies | The urgency levels to filter incidents by. | | | User IDs | The unique identifiers of the users currently assigned to the incidents to return. | PXPGF42 | Example Payload for List Incidents[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listIncidents.json "Download example payload") Loading… *** ### List Notifications[​](#listnotifications "Direct link to List Notifications") List notifications sent within a specified time range. | **key: listNotifications** | Input | Notes | Example | | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | Connection | The PagerDuty connection to use. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Filter | The notification type to filter results by. | | | Include | The additional details to include in the response. | | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Since | The start of the date range over which to search, as a UTC ISO 8601 datetime string. | 2020-07-17T07:42:58Z | | Time Zone | The TZInfo-formatted time zone in which results are rendered. Example: 'America/Los\_Angeles'. | America/Los\_Angeles | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | | Until | The end of the date range over which to search, as a UTC ISO 8601 datetime string. | 2020-07-17T07:42:58Z | Example Payload for List Notifications[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listNotifications.json "Download example payload") Loading… *** ### List Priorities[​](#listpriorities "Direct link to List Priorities") List available incident priorities. | **key: listPriorities** | Input | Notes | Example | | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | Example Payload for List Priorities[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listPriorities.json "Download example payload") Loading… *** ### List Services[​](#listservices "Direct link to List Services") List services with optional filters. | **key: listServices** | Input | Notes | Example | | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | Connection | The PagerDuty connection to use. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Include | The additional details to include in the response. | | | Limit | The maximum number of results to return per page. | 10 | | Name | The name to filter results by. Only services with the specified name are returned. | My Service | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Query | The search query used to filter results. Only records whose name matches the query are returned. | sampleName | | Sort By | The field used to sort the results. | | | Team IDs | The unique identifiers of the teams to filter results by. | PEYSGVF | | Time Zone | The TZInfo-formatted time zone in which results are rendered. Example: 'America/Los\_Angeles'. | America/Los\_Angeles | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | Example Payload for List Services[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listServices.json "Download example payload") Loading… *** ### List Templates[​](#gettemplates "Direct link to List Templates") List all templates with optional filters. | **key: getTemplates** | Input | Notes | Example | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | | Connection | The PagerDuty connection to use. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Query | The template name or description to search for. | Template Name 1 | | Sort By | The field and direction used to sort results. Field options: name, created\_at. Direction: asc or desc. | created\_at:asc | | Template Type | The template type used to filter results. | status\_update | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | Example Payload for List Templates[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/getTemplates.json "Download example payload") Loading… *** ### List Users[​](#listusers "Direct link to List Users") List all users with optional filters. | **key: listUsers** | Input | Notes | Example | | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | Connection | The PagerDuty connection to use. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Include | The additional models to include in the response. | | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Query | The search query used to filter results. Only records whose name matches the query are returned. | sampleName | | Team IDs | The unique identifiers of the teams to filter results by. | PEYSGVF | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | Example Payload for List Users[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listUsers.json "Download example payload") Loading… *** ### List Webhook Subscriptions[​](#listwebhooksubscriptions "Direct link to List Webhook Subscriptions") List webhook subscriptions with optional filters. | **key: listWebhookSubscriptions** | Input | Notes | Example | | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Fetch All | When true, automatically fetches all pages of results. When false, only the first page is returned. | false | | Filter ID | The unique identifier of the resource to filter results upon. | 123 | | Filter Type | The type of resource to filter results upon. | | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | Example Payload for List Webhook Subscriptions[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/listWebhookSubscriptions.json "Download example payload") Loading… *** ### Manage Incident Alerts[​](#updateincidentalerts "Direct link to Manage Incident Alerts") Update multiple alerts on an incident in bulk. | **key: updateIncidentAlerts** | Input | Notes | Example | | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------- | | Alerts | The JSON array of alert objects, including the parameters to update for each alert. | | | Connection | The PagerDuty connection to use. | | | Incident ID | The unique identifier for the incident. | PT4KHLK | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | Example Payload for Manage Incident Alerts[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateIncidentAlerts.json "Download example payload") Loading… *** ### Manage Incidents[​](#updateincidents "Direct link to Manage Incidents") Acknowledge, resolve, or update multiple incidents in bulk. | **key: updateIncidents** | Input | Notes | Example | | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | Incidents | The JSON array of incidents to manage, including the parameters to update. | See Example | | Limit | The maximum number of results to return per page. | 10 | | Offset | The number of results to skip before starting to return results. Used for pagination. | 18 | | Total | When true, the total field in pagination responses is populated. By default this field is null to provide the fastest possible response times. | false | Example Payload for Manage Incidents[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateIncidents.json "Download example payload") Loading… *** ### Raw Request[​](#rawrequest "Direct link to Raw Request") Issue a raw HTTP request | **key: rawRequest** | Input | Notes | Example | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- | | Connection | | | | Data | The HTTP body payload to send to the URL. | {"exampleKey": "Example Data"} | | Debug Request | Enabling this flag will log out the current request. | false | | File Data | File Data to be sent as a multipart form upload. | \[{key: "example.txt", value: "My File Contents"}] | | File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | | | Form Data | The Form Data to be sent as a multipart form upload. | \[{"key": "Example Key", "value": new Buffer("Hello World")}] | | Header | A list of headers to send with the request. | User-Agent: curl/7.64.1 | | Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 | | Method | The HTTP method to use. | | | Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1\&key2=value2. | | | Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json | | Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false | | Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 | | Timeout | The maximum time that a client will await a response to its request | 2000 | | URL | This is the URL to call. | /sobjects/Account | | Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false | *** ### Render Template[​](#rendertemplate "Direct link to Render Template") Render a template for a given incident. | **key: renderTemplate** | Input | Notes | Example | | -------------- | ------------------------------------------------------------------------ | --------------------- | | Connection | The PagerDuty connection to use. | | | Template ID | The unique identifier for the template. | PBZUP2B | | Incident ID | The unique identifier for the incident. | PT4KHLK | | Update Message | An optional status update message sent along with the rendered template. | Status update message | Example Payload for Render Template[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/renderTemplate.json "Download example payload") Loading… *** ### Send Change Event[​](#sendchangeevent "Direct link to Send Change Event") Send a change event to the Events API. | **key: sendChangeEvent** | Input | Notes | Example | | -------------------- | ----------------------------------------------------- | ----------- | | Change Event To Send | The JSON object describing the event payload to send. | See Example | Example Payload for Send Change Event[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/sendChangeEvent.json "Download example payload") Loading… *** ### Send Event[​](#sendevent "Direct link to Send Event") Send a trigger event to the Events API to report a new event. | **key: sendEvent** | Input | Notes | Example | | ------------- | ----------------------------------------------------- | ----------- | | Event to Send | The JSON object describing the event payload to send. | See Example | Example Payload for Send Event[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/sendEvent.json "Download example payload") Loading… *** ### Test Webhook Subscription[​](#testwebhooksubscription "Direct link to Test Webhook Subscription") Send a test ping to a webhook subscription. | **key: testWebhookSubscription** | Input | Notes | Example | | ---------- | -------------------------------------- | --------------- | | Connection | The PagerDuty connection to use. | | | Webhook ID | The unique identifier for the webhook. | sampleWebhookId | Example Payload for Test Webhook Subscription[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/testWebhookSubscription.json "Download example payload") Loading… *** ### Update Change Event[​](#updatechangeevent "Direct link to Update Change Event") Update an existing change event. | **key: updateChangeEvent** | Input | Notes | Example | | ---------------------- | ----------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | Change Event to Update | The JSON object describing the event payload to send. | See Example | | Event ID | The unique identifier for the change event. | 12 | Example Payload for Update Change Event[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateChangeEvent.json "Download example payload") Loading… *** ### Update Incident[​](#updateincident "Direct link to Update Incident") Update an existing incident. | **key: updateIncident** | Input | Notes | Example | | ----------- | -------------------------------------------------------------------- | ------- | | Connection | The PagerDuty connection to use. | | | Incident ID | The unique identifier for the incident. | PT4KHLK | | Incident | The JSON object containing the parameters of the incident to update. | | Example Payload for Update Incident[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateIncident.json "Download example payload") Loading… *** ### Update Incident Alert[​](#updateincidentalert "Direct link to Update Incident Alert") Update a single alert on an incident. | **key: updateIncidentAlert** | Input | Notes | Example | | ----------------- | ----------------------------------------------------------------------------------- | ------- | | Alerts | The JSON array of alert objects, including the parameters to update for each alert. | | | Incident Alert ID | The unique identifier for the incident alert. | PT4KHLK | | Connection | The PagerDuty connection to use. | | | Incident ID | The unique identifier for the incident. | PT4KHLK | Example Payload for Update Incident Alert[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateIncidentAlert.json "Download example payload") Loading… *** ### Update Service[​](#updateservice "Direct link to Update Service") Update an existing service. | **key: updateService** | Input | Notes | Example | | ---------- | ------------------------------------------------------ | ----------- | | Connection | The PagerDuty connection to use. | | | Service ID | The unique identifier for the service. | PIJ90N7 | | Service | The JSON object body describing the service to update. | See Example | Example Payload for Update Service[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateService.json "Download example payload") Loading… *** ### Update Template[​](#updatetemplate "Direct link to Update Template") Update an existing template. | **key: updateTemplate** | Input | Notes | Example | | ----------- | ------------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | Template ID | The unique identifier for the template. | PBZUP2B | | Template | The JSON object body describing the template to update. | See Example | Example Payload for Update Template[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateTemplate.json "Download example payload") Loading… *** ### Update User[​](#updateuser "Direct link to Update User") Update an existing user. | **key: updateUser** | Input | Notes | Example | | ---------- | --------------------------------------------------- | ----------- | | Connection | The PagerDuty connection to use. | | | User ID | The unique identifier for the user. | PXPGF42 | | User | The JSON object body describing the user to create. | See Example | Example Payload for Update User[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateUser.json "Download example payload") Loading… *** ### Update Webhook Subscription[​](#updatewebhooksubscription "Direct link to Update Webhook Subscription") Update an existing webhook subscription. | **key: updateWebhookSubscription** | Input | Notes | Example | | ---------------------- | ----------------------------------------------------------------- | --------------- | | Connection | The PagerDuty connection to use. | | | Webhook ID | The unique identifier for the webhook. | sampleWebhookId | | Update Webhook Payload | The JSON object body describing the updated webhook subscription. | See Example | Example Payload for Update Webhook Subscription[⤓](https://prismatic.io/docs/example-payloads/pagerduty/actions/updateWebhookSubscription.json "Download example payload") Loading… *** ## Changelog[​](#changelog "Direct link to Changelog") ### 2026-05-26[​](#2026-05-26 "Direct link to 2026-05-26") Added **New Incidents** polling trigger for detecting newly created incidents ### 2026-04-30[​](#2026-04-30 "Direct link to 2026-04-30") Various modernizations and documentation updates ### 2026-04-07[​](#2026-04-07 "Direct link to 2026-04-07") Various modernizations and documentation updates