PagerDuty

PagerDuty is a leading incident management platform that helps engineering and operations teams detect, triage, and resolve infrastructure and application issues in real time. PagerDuty integrates with monitoring tools, orchestrates on-call schedules, and ensures the right people are alerted when incidents occur.

The PagerDuty integration in Sim connects with the PagerDuty REST API v2 using API key authentication, enabling your agents to manage the full incident lifecycle and query on-call information programmatically.

With the PagerDuty integration, your agents can:

  • List and filter incidents: Retrieve incidents filtered by status (triggered, acknowledged, resolved), service, date range, and sort order to monitor your operational health
  • Create incidents: Trigger new incidents on specific services with custom titles, descriptions, urgency levels, and assignees directly from your workflows
  • Update incidents: Acknowledge or resolve incidents, change urgency, and add resolution notes to keep your incident management in sync with automated processes
  • Add notes to incidents: Attach contextual information, investigation findings, or automated diagnostics as notes on existing incidents
  • List services: Query your PagerDuty service catalog to discover service IDs and metadata for use in other operations
  • Check on-call schedules: Retrieve current on-call entries filtered by escalation policy or schedule to determine who is responsible at any given time

In Sim, the PagerDuty integration enables powerful incident automation scenarios. Your agents can automatically create incidents based on monitoring alerts, enrich incidents with diagnostic data from other tools, resolve incidents when automated remediation succeeds, or build escalation workflows that check on-call schedules and route notifications accordingly. By connecting Sim with PagerDuty, you can build intelligent agents that bridge the gap between detection and response, reducing mean time to resolution and ensuring consistent incident handling across your organization.

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

pagerduty_list_incidents

List incidents from PagerDuty with optional filters.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
statusesstringNoComma-separated statuses to filter (triggered, acknowledged, resolved)
urgenciesstringNoComma-separated urgencies to filter (high, low)
serviceIdsstringNoComma-separated service IDs to filter
sincestringNoStart date filter (ISO 8601 format)
untilstringNoEnd date filter (ISO 8601 format)
sortBystringNoSort field (e.g., created_at:desc)
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
incidentsarrayArray of incidents
idstringIncident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringIncident status
urgencystringIncident urgency
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
serviceNamestringService name
serviceIdstringService ID
assigneeNamestringAssignee name
assigneeIdstringAssignee ID
escalationPolicyNamestringEscalation policy name
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching incidents (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_get_incident

Get a single incident from PagerDuty by ID.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
incidentIdstringYesID of the incident to fetch

Output

ParameterTypeDescription
idstringIncident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringIncident status
urgencystringIncident urgency
createdAtstringCreation timestamp
updatedAtstringLast updated timestamp
resolvedAtstringResolution timestamp
serviceNamestringService name
serviceIdstringService ID
assigneeNamestringAssignee name
assigneeIdstringAssignee ID
escalationPolicyNamestringEscalation policy name
escalationPolicyIdstringEscalation policy ID
incidentKeystringDe-duplication key
htmlUrlstringPagerDuty web URL

pagerduty_create_incident

Create a new incident in PagerDuty.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
titlestringYesIncident title/summary
serviceIdstringYesID of the PagerDuty service
urgencystringNoUrgency level (high or low)
bodystringNoDetailed description of the incident
escalationPolicyIdstringNoEscalation policy ID to assign
assigneeIdstringNoUser ID to assign the incident to
incidentKeystringNoDe-duplication key. A subsequent request with the same service and incident key updates the existing open incident instead of creating a new one

Output

ParameterTypeDescription
idstringCreated incident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringIncident status
urgencystringIncident urgency
createdAtstringCreation timestamp
serviceNamestringService name
serviceIdstringService ID
htmlUrlstringPagerDuty web URL

pagerduty_update_incident

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

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
incidentIdstringYesID of the incident to update
statusstringNoNew status (triggered, acknowledged, or resolved)
titlestringNoNew incident title
urgencystringNoNew urgency (high or low)
escalationLevelstringNoEscalation level to escalate to
resolutionstringNoResolution note added to the incident's log entry. Only used when status is set to resolved

Output

ParameterTypeDescription
idstringIncident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringUpdated status
urgencystringUpdated urgency
updatedAtstringLast updated timestamp
htmlUrlstringPagerDuty web URL

pagerduty_snooze_incident

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

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
incidentIdstringYesID of the incident to snooze
durationstringYesNumber of seconds to snooze the incident for (1 to 604800)

Output

ParameterTypeDescription
idstringIncident ID
incidentNumbernumberIncident number
statusstringIncident status after snoozing
htmlUrlstringPagerDuty 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.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
targetIncidentIdstringYesID of the incident that will absorb the source incidents
sourceIncidentIdsstringYesComma-separated IDs of the incidents to merge into the target incident

Output

ParameterTypeDescription
idstringTarget incident ID
incidentNumbernumberTarget incident number
titlestringTarget incident title
statusstringTarget incident status
htmlUrlstringPagerDuty web URL

pagerduty_add_note

Add a note to an existing PagerDuty incident.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
fromEmailstringYesEmail address of a valid PagerDuty user
incidentIdstringYesID of the incident to add the note to
contentstringYesNote content text

Output

ParameterTypeDescription
idstringNote ID
contentstringNote content
createdAtstringCreation timestamp
userNamestringName of the user who created the note

pagerduty_list_incident_alerts

List the individual alerts attached to a PagerDuty incident.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
incidentIdstringYesID of the incident whose alerts to list
statusesstringNoComma-separated statuses to filter (triggered, resolved)
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
alertsarrayArray of alerts attached to the incident
idstringAlert ID
summarystringAlert summary
statusstringAlert status
severitystringAlert severity
createdAtstringCreation timestamp
alertKeystringDe-duplication key
serviceNamestringService name
serviceIdstringService ID
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching alerts (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_list_services

List services from PagerDuty with optional name filter.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
querystringNoFilter services by name
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
servicesarrayArray of services
idstringService ID
namestringService name
descriptionstringService description
statusstringService status
escalationPolicyNamestringEscalation policy name
escalationPolicyIdstringEscalation policy ID
createdAtstringCreation timestamp
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching services (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_get_service

Get a single service from PagerDuty by ID.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
serviceIdstringYesID of the service to fetch

Output

ParameterTypeDescription
idstringService ID
namestringService name
descriptionstringService description
statusstringService status
autoResolveTimeoutnumberSeconds before an open incident auto-resolves
acknowledgementTimeoutnumberSeconds before an acknowledged incident reverts to triggered
createdAtstringCreation timestamp
lastIncidentTimestampstringTimestamp of the most recent incident
escalationPolicyNamestringEscalation policy name
escalationPolicyIdstringEscalation policy ID
htmlUrlstringPagerDuty web URL

pagerduty_list_oncalls

List current on-call entries from PagerDuty.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
escalationPolicyIdsstringNoComma-separated escalation policy IDs to filter
scheduleIdsstringNoComma-separated schedule IDs to filter
sincestringNoStart time filter (ISO 8601 format)
untilstringNoEnd time filter (ISO 8601 format)
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
oncallsarrayArray of on-call entries
userNamestringOn-call user name
userIdstringOn-call user ID
escalationLevelnumberEscalation level
escalationPolicyNamestringEscalation policy name
escalationPolicyIdstringEscalation policy ID
scheduleNamestringSchedule name
scheduleIdstringSchedule ID
startstringOn-call start time
endstringOn-call end time
totalnumberTotal number of matching on-call entries (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_list_escalation_policies

List escalation policies from PagerDuty with an optional name filter.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
querystringNoFilter escalation policies by name
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
escalationPoliciesarrayArray of escalation policies
idstringEscalation policy ID
namestringEscalation policy name
descriptionstringEscalation policy description
numLoopsnumberNumber of times the policy repeats
onCallHandoffNotificationsstringHandoff notification setting (if_has_services or always)
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching escalation policies (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_list_schedules

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

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
querystringNoFilter schedules by name
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
schedulesarrayArray of on-call schedules
idstringSchedule ID
namestringSchedule name
descriptionstringSchedule description
timeZonestringSchedule time zone
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching schedules (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset used for this page of results

pagerduty_list_users

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

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
querystringNoFilter users by name or email
limitstringNoMaximum number of results (max 100)
offsetstringNoOffset to start pagination search results

Output

ParameterTypeDescription
usersarrayArray of users
idstringUser ID
namestringUser name
emailstringUser email
rolestringUser role
jobTitlestringUser job title
timeZonestringUser preferred time zone
htmlUrlstringPagerDuty web URL
totalnumberTotal number of matching users (null unless explicitly requested by PagerDuty)
morebooleanWhether more results are available
offsetnumberOffset 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.

Input

ParameterTypeRequiredDescription
routingKeystringYesThe Events API v2 integration key (routing key) for the target service
eventActionstringYesEvent action: trigger, acknowledge, or resolve
summarystringNoBrief summary of the event. Required when eventAction is trigger
sourcestringNoUnique location of the affected system (e.g. hostname). Required when eventAction is trigger
severitystringNoPerceived severity: critical, warning, error, or info. Required when eventAction is trigger
dedupKeystringNoDe-duplication key identifying the alert. Required when eventAction is acknowledge or resolve; optional on trigger
componentstringNoComponent of the source machine responsible for the event
groupstringNoLogical grouping of components of a service
classstringNoThe class/type of the event

Output

ParameterTypeDescription
statusstringResult status ("success" if accepted)
messagestringDescription of the result
dedupKeystringDe-duplication key for the alert

Triggers

A Trigger is a block that starts a workflow when an event happens in this service.

PagerDuty Incident Acknowledged

Trigger workflow when an incident is acknowledged in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Escalated

Trigger workflow when an incident is escalated in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Event

Trigger workflow from any PagerDuty incident event

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Reassigned

Trigger workflow when an incident is reassigned in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Resolved

Trigger workflow when an incident is resolved in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

PagerDuty Incident Triggered

Trigger workflow when a new incident is triggered in PagerDuty

Configuration

ParameterTypeRequiredDescription
apiKeystringYesUsed to create the webhook subscription. Must be a read/write REST API key.

Output

ParameterTypeDescription
event_idstringUnique ID of the webhook event
event_typestringEvent type (e.g. incident.triggered, incident.resolved)
occurred_atstringWhen the event occurred (ISO 8601)
agentjsonThe user or service that caused the event (may be null)
incidentobjectincident output from the tool
idstringIncident ID
numbernumberIncident number
titlestringIncident title
statusstringIncident status (triggered, acknowledged, resolved)
urgencystringIncident urgency (high or low)
html_urlstringWeb URL of the incident
created_atstringIncident creation timestamp
prioritystringPriority label (may be null)
serviceobjectservice output from the tool
idstringService ID
summarystringService name
html_urlstringService web URL
escalation_policyobjectescalation_policy output from the tool
idstringEscalation policy ID
summarystringEscalation policy name
html_urlstringEscalation policy web URL
assigneesjsonArray of assignee references ({ id, summary, html_url })

On this page