# PagerDuty (/integrations/pagerduty)





{/* MANUAL-CONTENT-START:intro */}

Use [PagerDuty](https://www.pagerduty.com/) to manage incidents, add investigation notes, and find services, escalation policies, and on-call responders. The REST API uses API-key authentication; Send Event uses Events API v2.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Integrate PagerDuty into your workflow to list, get, create, update, snooze, and merge incidents, add notes and list alerts, look up services and escalation policies, check on-call schedules, list users, and send monitoring events through the Events API v2.

## Actions [#actions]

### PagerDuty List Incidents [#pagerduty-list-incidents]

List incidents from PagerDuty with optional filters.

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `statuses` | string | No | Comma-separated statuses to filter (triggered, acknowledged, resolved) |
  | `urgencies` | string | No | Comma-separated urgencies to filter (high, low) |
  | `serviceIds` | string | No | Comma-separated service IDs to filter |
  | `since` | string | No | Start date filter (ISO 8601 format) |
  | `until` | string | No | End date filter (ISO 8601 format) |
  | `sortBy` | string | No | Sort field (e.g., created\_at:desc) |
  | `limit` | string | No | Maximum number of results (max 100) |
  | `offset` | string | No | Offset to start pagination search results |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `incidents` | array | Array of incidents |
  | ↳ `id` | string | Incident ID |
  | ↳ `incidentNumber` | number | Incident number |
  | ↳ `title` | string | Incident title |
  | ↳ `status` | string | Incident status |
  | ↳ `urgency` | string | Incident urgency |
  | ↳ `createdAt` | string | Creation timestamp |
  | ↳ `updatedAt` | string | Last updated timestamp |
  | ↳ `serviceName` | string | Service name |
  | ↳ `serviceId` | string | Service ID |
  | ↳ `assigneeName` | string | Assignee name |
  | ↳ `assigneeId` | string | Assignee ID |
  | ↳ `escalationPolicyName` | string | Escalation policy name |
  | ↳ `htmlUrl` | string | PagerDuty web URL |
  | `total` | number | Total number of matching incidents (null unless explicitly requested by PagerDuty) |
  | `more` | boolean | Whether more results are available |
  | `offset` | number | Offset used for this page of results |
</ReferenceDetails>

### PagerDuty Get Incident [#pagerduty-get-incident]

Get a single incident from PagerDuty by ID.

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `incidentId` | string | Yes | ID of the incident to fetch |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Incident ID |
  | `incidentNumber` | number | Incident number |
  | `title` | string | Incident title |
  | `status` | string | Incident status |
  | `urgency` | string | Incident urgency |
  | `createdAt` | string | Creation timestamp |
  | `updatedAt` | string | Last updated timestamp |
  | `resolvedAt` | string | Resolution timestamp |
  | `serviceName` | string | Service name |
  | `serviceId` | string | Service ID |
  | `assigneeName` | string | Assignee name |
  | `assigneeId` | string | Assignee ID |
  | `escalationPolicyName` | string | Escalation policy name |
  | `escalationPolicyId` | string | Escalation policy ID |
  | `incidentKey` | string | De-duplication key |
  | `htmlUrl` | string | PagerDuty web URL |
</ReferenceDetails>

### PagerDuty Create Incident [#pagerduty-create-incident]

Create a new incident in PagerDuty.

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `fromEmail` | string | Yes | Email address of a valid PagerDuty user |
  | `title` | string | Yes | Incident title/summary |
  | `serviceId` | string | Yes | ID of the PagerDuty service |
  | `urgency` | string | No | Urgency level (high or low) |
  | `body` | string | No | Detailed description of the incident |
  | `escalationPolicyId` | string | No | Escalation policy ID to assign |
  | `assigneeId` | string | No | User ID to assign the incident to |
  | `incidentKey` | string | No | De-duplication key. A subsequent request with the same service and incident key updates the existing open incident instead of creating a new one |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Created incident ID |
  | `incidentNumber` | number | Incident number |
  | `title` | string | Incident title |
  | `status` | string | Incident status |
  | `urgency` | string | Incident urgency |
  | `createdAt` | string | Creation timestamp |
  | `serviceName` | string | Service name |
  | `serviceId` | string | Service ID |
  | `htmlUrl` | string | PagerDuty web URL |
</ReferenceDetails>

### PagerDuty Update Incident [#pagerduty-update-incident]

Update an incident in PagerDuty (acknowledge, resolve, change urgency, etc.).

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `fromEmail` | string | Yes | Email address of a valid PagerDuty user |
  | `incidentId` | string | Yes | ID of the incident to update |
  | `status` | string | No | New status (triggered, acknowledged, or resolved) |
  | `title` | string | No | New incident title |
  | `urgency` | string | No | New urgency (high or low) |
  | `escalationLevel` | string | No | Escalation level to escalate to |
  | `resolution` | string | No | Resolution note added to the incident's log entry. Only used when status is set to resolved |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Incident ID |
  | `incidentNumber` | number | Incident number |
  | `title` | string | Incident title |
  | `status` | string | Updated status |
  | `urgency` | string | Updated urgency |
  | `updatedAt` | string | Last updated timestamp |
  | `htmlUrl` | string | PagerDuty web URL |
</ReferenceDetails>

### PagerDuty Snooze Incident [#pagerduty-snooze-incident]

Snooze a triggered PagerDuty incident for a number of seconds, after which it returns to triggered.

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `fromEmail` | string | Yes | Email address of a valid PagerDuty user |
  | `incidentId` | string | Yes | ID of the incident to snooze |
  | `duration` | string | Yes | Number of seconds to snooze the incident for (1 to 604800) |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Incident ID |
  | `incidentNumber` | number | Incident number |
  | `status` | string | Incident status after snoozing |
  | `htmlUrl` | string | PagerDuty web URL |
</ReferenceDetails>

### PagerDuty Merge Incidents [#pagerduty-merge-incidents]

Merge one or more source incidents into a target incident. Source incidents are resolved and their alerts move to the target.

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `fromEmail` | string | Yes | Email address of a valid PagerDuty user |
  | `targetIncidentId` | string | Yes | ID of the incident that will absorb the source incidents |
  | `sourceIncidentIds` | string | Yes | Comma-separated IDs of the incidents to merge into the target incident |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Target incident ID |
  | `incidentNumber` | number | Target incident number |
  | `title` | string | Target incident title |
  | `status` | string | Target incident status |
  | `htmlUrl` | string | PagerDuty web URL |
</ReferenceDetails>

### PagerDuty Add Note [#pagerduty-add-note]

Add a note to an existing PagerDuty incident.

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `fromEmail` | string | Yes | Email address of a valid PagerDuty user |
  | `incidentId` | string | Yes | ID of the incident to add the note to |
  | `content` | string | Yes | Note content text |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Note ID |
  | `content` | string | Note content |
  | `createdAt` | string | Creation timestamp |
  | `userName` | string | Name of the user who created the note |
</ReferenceDetails>

### PagerDuty List Incident Alerts [#pagerduty-list-incident-alerts]

List the individual alerts attached to a PagerDuty incident.

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `incidentId` | string | Yes | ID of the incident whose alerts to list |
  | `statuses` | string | No | Comma-separated statuses to filter (triggered, resolved) |
  | `limit` | string | No | Maximum number of results (max 100) |
  | `offset` | string | No | Offset to start pagination search results |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `alerts` | array | Array of alerts attached to the incident |
  | ↳ `id` | string | Alert ID |
  | ↳ `summary` | string | Alert summary |
  | ↳ `status` | string | Alert status |
  | ↳ `severity` | string | Alert severity |
  | ↳ `createdAt` | string | Creation timestamp |
  | ↳ `alertKey` | string | De-duplication key |
  | ↳ `serviceName` | string | Service name |
  | ↳ `serviceId` | string | Service ID |
  | ↳ `htmlUrl` | string | PagerDuty web URL |
  | `total` | number | Total number of matching alerts (null unless explicitly requested by PagerDuty) |
  | `more` | boolean | Whether more results are available |
  | `offset` | number | Offset used for this page of results |
</ReferenceDetails>

### PagerDuty List Services [#pagerduty-list-services]

List services from PagerDuty with optional name filter.

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `query` | string | No | Filter services by name |
  | `limit` | string | No | Maximum number of results (max 100) |
  | `offset` | string | No | Offset to start pagination search results |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `services` | array | Array of services |
  | ↳ `id` | string | Service ID |
  | ↳ `name` | string | Service name |
  | ↳ `description` | string | Service description |
  | ↳ `status` | string | Service status |
  | ↳ `escalationPolicyName` | string | Escalation policy name |
  | ↳ `escalationPolicyId` | string | Escalation policy ID |
  | ↳ `createdAt` | string | Creation timestamp |
  | ↳ `htmlUrl` | string | PagerDuty web URL |
  | `total` | number | Total number of matching services (null unless explicitly requested by PagerDuty) |
  | `more` | boolean | Whether more results are available |
  | `offset` | number | Offset used for this page of results |
</ReferenceDetails>

### PagerDuty Get Service [#pagerduty-get-service]

Get a single service from PagerDuty by ID.

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `serviceId` | string | Yes | ID of the service to fetch |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `id` | string | Service ID |
  | `name` | string | Service name |
  | `description` | string | Service description |
  | `status` | string | Service status |
  | `autoResolveTimeout` | number | Seconds before an open incident auto-resolves |
  | `acknowledgementTimeout` | number | Seconds before an acknowledged incident reverts to triggered |
  | `createdAt` | string | Creation timestamp |
  | `lastIncidentTimestamp` | string | Timestamp of the most recent incident |
  | `escalationPolicyName` | string | Escalation policy name |
  | `escalationPolicyId` | string | Escalation policy ID |
  | `htmlUrl` | string | PagerDuty web URL |
</ReferenceDetails>

### PagerDuty List On-Calls [#pagerduty-list-on-calls]

List current on-call entries from PagerDuty.

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `escalationPolicyIds` | string | No | Comma-separated escalation policy IDs to filter |
  | `scheduleIds` | string | No | Comma-separated schedule IDs to filter |
  | `since` | string | No | Start time filter (ISO 8601 format) |
  | `until` | string | No | End time filter (ISO 8601 format) |
  | `limit` | string | No | Maximum number of results (max 100) |
  | `offset` | string | No | Offset to start pagination search results |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `oncalls` | array | Array of on-call entries |
  | ↳ `userName` | string | On-call user name |
  | ↳ `userId` | string | On-call user ID |
  | ↳ `escalationLevel` | number | Escalation level |
  | ↳ `escalationPolicyName` | string | Escalation policy name |
  | ↳ `escalationPolicyId` | string | Escalation policy ID |
  | ↳ `scheduleName` | string | Schedule name |
  | ↳ `scheduleId` | string | Schedule ID |
  | ↳ `start` | string | On-call start time |
  | ↳ `end` | string | On-call end time |
  | `total` | number | Total number of matching on-call entries (null unless explicitly requested by PagerDuty) |
  | `more` | boolean | Whether more results are available |
  | `offset` | number | Offset used for this page of results |
</ReferenceDetails>

### PagerDuty List Escalation Policies [#pagerduty-list-escalation-policies]

List escalation policies from PagerDuty with an optional name filter.

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `query` | string | No | Filter escalation policies by name |
  | `limit` | string | No | Maximum number of results (max 100) |
  | `offset` | string | No | Offset to start pagination search results |

  #### Output [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `escalationPolicies` | array | Array of escalation policies |
  | ↳ `id` | string | Escalation policy ID |
  | ↳ `name` | string | Escalation policy name |
  | ↳ `description` | string | Escalation policy description |
  | ↳ `numLoops` | number | Number of times the policy repeats |
  | ↳ `onCallHandoffNotifications` | string | Handoff notification setting (if\_has\_services or always) |
  | ↳ `htmlUrl` | string | PagerDuty web URL |
  | `total` | number | Total number of matching escalation policies (null unless explicitly requested by PagerDuty) |
  | `more` | boolean | Whether more results are available |
  | `offset` | number | Offset used for this page of results |
</ReferenceDetails>

### PagerDuty List Schedules [#pagerduty-list-schedules]

List on-call schedules from PagerDuty with an optional name filter.

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `query` | string | No | Filter schedules by name |
  | `limit` | string | No | Maximum number of results (max 100) |
  | `offset` | string | No | Offset to start pagination search results |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `schedules` | array | Array of on-call schedules |
  | ↳ `id` | string | Schedule ID |
  | ↳ `name` | string | Schedule name |
  | ↳ `description` | string | Schedule description |
  | ↳ `timeZone` | string | Schedule time zone |
  | ↳ `htmlUrl` | string | PagerDuty web URL |
  | `total` | number | Total number of matching schedules (null unless explicitly requested by PagerDuty) |
  | `more` | boolean | Whether more results are available |
  | `offset` | number | Offset used for this page of results |
</ReferenceDetails>

### PagerDuty List Users [#pagerduty-list-users]

List users from PagerDuty with an optional name/email filter.

<ReferenceDetails>
  #### Input [#input-13]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | PagerDuty REST API Key |
  | `query` | string | No | Filter users by name or email |
  | `limit` | string | No | Maximum number of results (max 100) |
  | `offset` | string | No | Offset to start pagination search results |

  #### Output [#output-13]

  | Parameter | Type | Description |
  | - | - | - |
  | `users` | array | Array of users |
  | ↳ `id` | string | User ID |
  | ↳ `name` | string | User name |
  | ↳ `email` | string | User email |
  | ↳ `role` | string | User role |
  | ↳ `jobTitle` | string | User job title |
  | ↳ `timeZone` | string | User preferred time zone |
  | ↳ `htmlUrl` | string | PagerDuty web URL |
  | `total` | number | Total number of matching users (null unless explicitly requested by PagerDuty) |
  | `more` | boolean | Whether more results are available |
  | `offset` | number | Offset used for this page of results |
</ReferenceDetails>

### PagerDuty Send Event [#pagerduty-send-event]

Send a trigger, acknowledge, or resolve event to PagerDuty Events API v2 using a service integration key. Used to page from monitoring/alerting sources without a PagerDuty user account.

<ReferenceDetails>
  #### Input [#input-14]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `routingKey` | string | Yes | The Events API v2 integration key (routing key) for the target service |
  | `eventAction` | string | Yes | Event action: trigger, acknowledge, or resolve |
  | `summary` | string | No | Brief summary of the event. Required when eventAction is trigger |
  | `source` | string | No | Unique location of the affected system (e.g. hostname). Required when eventAction is trigger |
  | `severity` | string | No | Perceived severity: critical, warning, error, or info. Required when eventAction is trigger |
  | `dedupKey` | string | No | De-duplication key identifying the alert. Required when eventAction is acknowledge or resolve; optional on trigger |
  | `component` | string | No | Component of the source machine responsible for the event |
  | `group` | string | No | Logical grouping of components of a service |
  | `class` | string | No | The class/type of the event |

  #### Output [#output-14]

  | Parameter | Type | Description |
  | - | - | - |
  | `status` | string | Result status ("success" if accepted) |
  | `message` | string | Description of the result |
  | `dedupKey` | string | De-duplication key for the alert |
</ReferenceDetails>

## Triggers [#triggers]

A trigger starts a workflow when a supported event occurs in this service.

### PagerDuty Incident Acknowledged [#pagerduty-incident-acknowledged]

Trigger workflow when an incident is acknowledged in PagerDuty

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Used to create the webhook subscription. Must be a read/write REST API key. |

  #### Output [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `event_id` | string | Unique ID of the webhook event |
  | `event_type` | string | Event type (e.g. incident.triggered, incident.resolved) |
  | `occurred_at` | string | When the event occurred (ISO 8601) |
  | `agent` | json | The user or service that caused the event (may be null) |
  | `incident` | object | |
  | ↳ `id` | string | Incident ID |
  | ↳ `number` | number | Incident number |
  | ↳ `title` | string | Incident title |
  | ↳ `status` | string | Incident status (triggered, acknowledged, resolved) |
  | ↳ `urgency` | string | Incident urgency (high or low) |
  | ↳ `html_url` | string | Web URL of the incident |
  | ↳ `created_at` | string | Incident creation timestamp |
  | ↳ `priority` | string | Priority label (may be null) |
  | ↳ `service` | object | |
  | ↳ `id` | string | Service ID |
  | ↳ `summary` | string | Service name |
  | ↳ `html_url` | string | Service web URL |
  | ↳ `escalation_policy` | object | |
  | ↳ `id` | string | Escalation policy ID |
  | ↳ `summary` | string | Escalation policy name |
  | ↳ `html_url` | string | Escalation policy web URL |
  | ↳ `assignees` | json | Array of assignee references (\{ id, summary, html\_url }) |
</ReferenceDetails>

### PagerDuty Incident Escalated [#pagerduty-incident-escalated]

Trigger workflow when an incident is escalated in PagerDuty

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Used to create the webhook subscription. Must be a read/write REST API key. |

  #### Output [#output-16]

  | Parameter | Type | Description |
  | - | - | - |
  | `event_id` | string | Unique ID of the webhook event |
  | `event_type` | string | Event type (e.g. incident.triggered, incident.resolved) |
  | `occurred_at` | string | When the event occurred (ISO 8601) |
  | `agent` | json | The user or service that caused the event (may be null) |
  | `incident` | object | |
  | ↳ `id` | string | Incident ID |
  | ↳ `number` | number | Incident number |
  | ↳ `title` | string | Incident title |
  | ↳ `status` | string | Incident status (triggered, acknowledged, resolved) |
  | ↳ `urgency` | string | Incident urgency (high or low) |
  | ↳ `html_url` | string | Web URL of the incident |
  | ↳ `created_at` | string | Incident creation timestamp |
  | ↳ `priority` | string | Priority label (may be null) |
  | ↳ `service` | object | |
  | ↳ `id` | string | Service ID |
  | ↳ `summary` | string | Service name |
  | ↳ `html_url` | string | Service web URL |
  | ↳ `escalation_policy` | object | |
  | ↳ `id` | string | Escalation policy ID |
  | ↳ `summary` | string | Escalation policy name |
  | ↳ `html_url` | string | Escalation policy web URL |
  | ↳ `assignees` | json | Array of assignee references (\{ id, summary, html\_url }) |
</ReferenceDetails>

### PagerDuty Incident Event [#pagerduty-incident-event]

Trigger workflow from any PagerDuty incident event

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Used to create the webhook subscription. Must be a read/write REST API key. |

  #### Output [#output-17]

  | Parameter | Type | Description |
  | - | - | - |
  | `event_id` | string | Unique ID of the webhook event |
  | `event_type` | string | Event type (e.g. incident.triggered, incident.resolved) |
  | `occurred_at` | string | When the event occurred (ISO 8601) |
  | `agent` | json | The user or service that caused the event (may be null) |
  | `incident` | object | |
  | ↳ `id` | string | Incident ID |
  | ↳ `number` | number | Incident number |
  | ↳ `title` | string | Incident title |
  | ↳ `status` | string | Incident status (triggered, acknowledged, resolved) |
  | ↳ `urgency` | string | Incident urgency (high or low) |
  | ↳ `html_url` | string | Web URL of the incident |
  | ↳ `created_at` | string | Incident creation timestamp |
  | ↳ `priority` | string | Priority label (may be null) |
  | ↳ `service` | object | |
  | ↳ `id` | string | Service ID |
  | ↳ `summary` | string | Service name |
  | ↳ `html_url` | string | Service web URL |
  | ↳ `escalation_policy` | object | |
  | ↳ `id` | string | Escalation policy ID |
  | ↳ `summary` | string | Escalation policy name |
  | ↳ `html_url` | string | Escalation policy web URL |
  | ↳ `assignees` | json | Array of assignee references (\{ id, summary, html\_url }) |
</ReferenceDetails>

### PagerDuty Incident Reassigned [#pagerduty-incident-reassigned]

Trigger workflow when an incident is reassigned in PagerDuty

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Used to create the webhook subscription. Must be a read/write REST API key. |

  #### Output [#output-18]

  | Parameter | Type | Description |
  | - | - | - |
  | `event_id` | string | Unique ID of the webhook event |
  | `event_type` | string | Event type (e.g. incident.triggered, incident.resolved) |
  | `occurred_at` | string | When the event occurred (ISO 8601) |
  | `agent` | json | The user or service that caused the event (may be null) |
  | `incident` | object | |
  | ↳ `id` | string | Incident ID |
  | ↳ `number` | number | Incident number |
  | ↳ `title` | string | Incident title |
  | ↳ `status` | string | Incident status (triggered, acknowledged, resolved) |
  | ↳ `urgency` | string | Incident urgency (high or low) |
  | ↳ `html_url` | string | Web URL of the incident |
  | ↳ `created_at` | string | Incident creation timestamp |
  | ↳ `priority` | string | Priority label (may be null) |
  | ↳ `service` | object | |
  | ↳ `id` | string | Service ID |
  | ↳ `summary` | string | Service name |
  | ↳ `html_url` | string | Service web URL |
  | ↳ `escalation_policy` | object | |
  | ↳ `id` | string | Escalation policy ID |
  | ↳ `summary` | string | Escalation policy name |
  | ↳ `html_url` | string | Escalation policy web URL |
  | ↳ `assignees` | json | Array of assignee references (\{ id, summary, html\_url }) |
</ReferenceDetails>

### PagerDuty Incident Resolved [#pagerduty-incident-resolved]

Trigger workflow when an incident is resolved in PagerDuty

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Used to create the webhook subscription. Must be a read/write REST API key. |

  #### Output [#output-19]

  | Parameter | Type | Description |
  | - | - | - |
  | `event_id` | string | Unique ID of the webhook event |
  | `event_type` | string | Event type (e.g. incident.triggered, incident.resolved) |
  | `occurred_at` | string | When the event occurred (ISO 8601) |
  | `agent` | json | The user or service that caused the event (may be null) |
  | `incident` | object | |
  | ↳ `id` | string | Incident ID |
  | ↳ `number` | number | Incident number |
  | ↳ `title` | string | Incident title |
  | ↳ `status` | string | Incident status (triggered, acknowledged, resolved) |
  | ↳ `urgency` | string | Incident urgency (high or low) |
  | ↳ `html_url` | string | Web URL of the incident |
  | ↳ `created_at` | string | Incident creation timestamp |
  | ↳ `priority` | string | Priority label (may be null) |
  | ↳ `service` | object | |
  | ↳ `id` | string | Service ID |
  | ↳ `summary` | string | Service name |
  | ↳ `html_url` | string | Service web URL |
  | ↳ `escalation_policy` | object | |
  | ↳ `id` | string | Escalation policy ID |
  | ↳ `summary` | string | Escalation policy name |
  | ↳ `html_url` | string | Escalation policy web URL |
  | ↳ `assignees` | json | Array of assignee references (\{ id, summary, html\_url }) |
</ReferenceDetails>

### PagerDuty Incident Triggered [#pagerduty-incident-triggered]

Trigger workflow when a new incident is triggered in PagerDuty

<ReferenceDetails label="Configuration and outputs">
  #### Configuration [#configuration-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Used to create the webhook subscription. Must be a read/write REST API key. |

  #### Output [#output-20]

  | Parameter | Type | Description |
  | - | - | - |
  | `event_id` | string | Unique ID of the webhook event |
  | `event_type` | string | Event type (e.g. incident.triggered, incident.resolved) |
  | `occurred_at` | string | When the event occurred (ISO 8601) |
  | `agent` | json | The user or service that caused the event (may be null) |
  | `incident` | object | |
  | ↳ `id` | string | Incident ID |
  | ↳ `number` | number | Incident number |
  | ↳ `title` | string | Incident title |
  | ↳ `status` | string | Incident status (triggered, acknowledged, resolved) |
  | ↳ `urgency` | string | Incident urgency (high or low) |
  | ↳ `html_url` | string | Web URL of the incident |
  | ↳ `created_at` | string | Incident creation timestamp |
  | ↳ `priority` | string | Priority label (may be null) |
  | ↳ `service` | object | |
  | ↳ `id` | string | Service ID |
  | ↳ `summary` | string | Service name |
  | ↳ `html_url` | string | Service web URL |
  | ↳ `escalation_policy` | object | |
  | ↳ `id` | string | Escalation policy ID |
  | ↳ `summary` | string | Escalation policy name |
  | ↳ `html_url` | string | Escalation policy web URL |
  | ↳ `assignees` | json | Array of assignee references (\{ id, summary, html\_url }) |
</ReferenceDetails>