PagerDuty

Use PagerDuty 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.

Use the block

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

PagerDuty List Incidents

List incidents from PagerDuty with optional filters.

Inputs and outputs

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

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

PagerDuty Get Incident

Get a single incident from PagerDuty by ID.

Inputs and outputs

Input

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

Output

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

PagerDuty Create Incident

Create a new incident in PagerDuty.

Inputs and outputs

Input

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

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

PagerDuty Update Incident

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

Inputs and outputs

Input

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

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

PagerDuty Snooze Incident

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

Inputs and outputs

Input

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

Parameter	Type	Description
id	string	Incident ID
incidentNumber	number	Incident number
status	string	Incident status after snoozing
htmlUrl	string	PagerDuty web URL

PagerDuty Merge Incidents

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

Inputs and outputs

Input

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

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

PagerDuty Add Note

Add a note to an existing PagerDuty incident.

Inputs and outputs

Input

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

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

PagerDuty List Incident Alerts

List the individual alerts attached to a PagerDuty incident.

Inputs and outputs

Input

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

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

PagerDuty List Services

List services from PagerDuty with optional name filter.

Inputs and outputs

Input

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

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

PagerDuty Get Service

Get a single service from PagerDuty by ID.

Inputs and outputs

Input

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

Output

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

PagerDuty List On-Calls

List current on-call entries from PagerDuty.

Inputs and outputs

Input

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

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

PagerDuty List Escalation Policies

List escalation policies from PagerDuty with an optional name filter.

Inputs and outputs

Input

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

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

PagerDuty List Schedules

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

Inputs and outputs

Input

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

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

PagerDuty List Users

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

Inputs and outputs

Input

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

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

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.

Inputs and outputs

Input

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

Parameter	Type	Description
status	string	Result status ("success" if accepted)
message	string	Description of the result
dedupKey	string	De-duplication key for the alert

Triggers

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

PagerDuty Incident Acknowledged

Trigger workflow when an incident is acknowledged in PagerDuty

Configuration and outputs

Configuration

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

Output

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

PagerDuty Incident Escalated

Trigger workflow when an incident is escalated in PagerDuty

Configuration and outputs

Configuration

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

Output

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

PagerDuty Incident Event

Trigger workflow from any PagerDuty incident event

Configuration and outputs

Configuration

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

Output

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

PagerDuty Incident Reassigned

Trigger workflow when an incident is reassigned in PagerDuty

Configuration and outputs

Configuration

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

Output

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

PagerDuty Incident Resolved

Trigger workflow when an incident is resolved in PagerDuty

Configuration and outputs

Configuration

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

Output

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

PagerDuty Incident Triggered

Trigger workflow when a new incident is triggered in PagerDuty

Configuration and outputs

Configuration

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

Output

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