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
paymentsservice 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.
- Go to Organization > Connectors and find PagerDuty. Click Enable, and choose which tools to allow.
- Create an OAuth application in the PagerDuty developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- 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.readaudit_records.readescalation_policies.readescalation_policies.writeincidents.readincidents.writelog_entries.readmaintenance_windows.readmaintenance_windows.writeoncalls.readpriorities.readschedules.readschedules.writeservices.readservices.writetags.readtags.writeteams.readteams.writeusers.readusers.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.
| Tool | What it does |
|---|---|
get_escalation_policy | Get an escalation policy by ID. |
get_incident | Get a specific incident by ID. |
get_incident_analytics | Get aggregated incident metrics across the account. |
get_maintenance_window | Get a maintenance window by ID. |
get_schedule | Get a schedule by ID with rendered on-call entries. |
get_service | Get a specific service by ID. |
get_service_analytics | Get aggregated metrics broken down by service. |
get_team | Get a specific team by ID. |
get_user | Get a specific user by ID. |
list_audit_records | List audit records across the account. |
list_escalation_policies | List escalation policies with optional filters. |
list_incident_alerts | List alerts for an incident. |
list_incident_log_entries | List log entries for an incident. |
list_incident_notes | List notes on an incident. |
list_incidents | List incidents with optional filters for status, urgency, service, date range. |
list_log_entries | List log entries across the account. |
list_maintenance_windows | List maintenance windows. |
list_oncalls | List who is currently on-call. |
list_priorities | List priority levels configured in PagerDuty. |
list_schedules | List on-call schedules with optional name filter. |
list_services | List services with optional filters. |
list_tags | List tags with optional name filter. |
list_teams | List teams with optional name filter. |
list_users | List users with optional filters by name, email, or team. |
validate_credential | Validate PagerDuty credentials by testing API access. |
Write (9)
Create or send data.
| Tool | What it does |
|---|---|
create_escalation_policy | Create an escalation policy. |
create_incident | Create a new incident. |
create_incident_note | Add a note to an incident. |
create_maintenance_window | Create a maintenance window. |
create_schedule | Create an on-call schedule. |
create_service | Create a new service. |
create_tag | Create a new tag. |
create_team | Create a new team. |
create_user | Create a new user. |
Delete or overwrite (13)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_escalation_policy | Delete an escalation policy by ID. |
delete_maintenance_window | Delete a maintenance window by ID. |
delete_schedule | Delete a schedule by ID. |
delete_service | Delete a service by ID. |
delete_team | Delete a team by ID. |
delete_user | Delete a user by ID. |
update_escalation_policy | Update an escalation policy. |
update_incident | Update an incident. |
update_maintenance_window | Update a maintenance window. |
update_schedule | Update a schedule. |
update_service | Update a service. |
update_team | Update a team. |
update_user | Update a user. |