Skip to main content

PagerDuty

Incident management connector for managing incidents, services, users, teams, schedules, and on-call rotations.

What you can ask​

  • Show me incidents from the last 24 hours, grouped by service.
  • Trigger an incident on the payments service with severity SEV2 and page the on-call.
  • Pull on-call rotation for the next 7 days and post in #engineering.

Set up​

PagerDuty needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find PagerDuty. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the PagerDuty developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or PagerDuty login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (21)

Grant the scopes for the tools you plan to allow.

  • analytics.read
  • audit_records.read
  • escalation_policies.read
  • escalation_policies.write
  • incidents.read
  • incidents.write
  • log_entries.read
  • maintenance_windows.read
  • maintenance_windows.write
  • oncalls.read
  • priorities.read
  • schedules.read
  • schedules.write
  • services.read
  • services.write
  • tags.read
  • tags.write
  • teams.read
  • teams.write
  • users.read
  • users.write

Tools​

PagerDuty offers 47 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (25)​

View and search information without changing it.

ToolWhat it does
get_escalation_policyGet an escalation policy by ID.
get_incidentGet a specific incident by ID.
get_incident_analyticsGet aggregated incident metrics across the account.
get_maintenance_windowGet a maintenance window by ID.
get_scheduleGet a schedule by ID with rendered on-call entries.
get_serviceGet a specific service by ID.
get_service_analyticsGet aggregated metrics broken down by service.
get_teamGet a specific team by ID.
get_userGet a specific user by ID.
list_audit_recordsList audit records across the account.
list_escalation_policiesList escalation policies with optional filters.
list_incident_alertsList alerts for an incident.
list_incident_log_entriesList log entries for an incident.
list_incident_notesList notes on an incident.
list_incidentsList incidents with optional filters for status, urgency, service, date range.
list_log_entriesList log entries across the account.
list_maintenance_windowsList maintenance windows.
list_oncallsList who is currently on-call.
list_prioritiesList priority levels configured in PagerDuty.
list_schedulesList on-call schedules with optional name filter.
list_servicesList services with optional filters.
list_tagsList tags with optional name filter.
list_teamsList teams with optional name filter.
list_usersList users with optional filters by name, email, or team.
validate_credentialValidate PagerDuty credentials by testing API access.

Write (9)​

Create or send data.

ToolWhat it does
create_escalation_policyCreate an escalation policy.
create_incidentCreate a new incident.
create_incident_noteAdd a note to an incident.
create_maintenance_windowCreate a maintenance window.
create_scheduleCreate an on-call schedule.
create_serviceCreate a new service.
create_tagCreate a new tag.
create_teamCreate a new team.
create_userCreate a new user.

Delete or overwrite (13)​

Remove or replace existing data.

ToolWhat it does
delete_escalation_policyDelete an escalation policy by ID.
delete_maintenance_windowDelete a maintenance window by ID.
delete_scheduleDelete a schedule by ID.
delete_serviceDelete a service by ID.
delete_teamDelete a team by ID.
delete_userDelete a user by ID.
update_escalation_policyUpdate an escalation policy.
update_incidentUpdate an incident.
update_maintenance_windowUpdate a maintenance window.
update_scheduleUpdate a schedule.
update_serviceUpdate a service.
update_teamUpdate a team.
update_userUpdate a user.
⌘J