PagerDuty

Manage incidents and on-call schedules with 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, create, and update incidents, add notes, list services, and check on-call schedules.

Tools

pagerduty_list_incidents

List incidents from PagerDuty with optional filters.

Input

ParameterTypeRequiredDescription
apiKeystringYesPagerDuty REST API Key
statusesstringNoComma-separated statuses to filter (triggered, acknowledged, resolved)
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)

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
morebooleanWhether more results are available

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

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 (acknowledged or resolved)
titlestringNoNew incident title
urgencystringNoNew urgency (high or low)
escalationLevelstringNoEscalation level to escalate to

Output

ParameterTypeDescription
idstringIncident ID
incidentNumbernumberIncident number
titlestringIncident title
statusstringUpdated status
urgencystringUpdated urgency
updatedAtstringLast updated timestamp
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_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)

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
morebooleanWhether more results are available

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)

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
morebooleanWhether more results are available

On this page

Start building today
Trusted by over 70,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started