PagerDuty (Preview)
PagerDuty is an agile incident management platform that integrates with IT Ops and DevOps monitoring stacks to improve operational reliability and agility for organizations.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Standard | All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://www.pagerduty.com/ |
| Privacy policy | https://www.pagerduty.com/privacy-policy/ |
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| PagerDuty API Key | securestring | PagerDuty API Key | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 30 | 60 seconds |
| Frequency of trigger polls | 1 | 30 seconds |
Actions
| Acknowledge incident |
Acknowledge a given incident. |
| Add note to incident |
Add note to a given incident. |
| Create incident |
Creates a new incident for a given service identifiable by the integration key. |
| Escalate incident |
Use a given escalation policy on an incident. |
| Get incident |
Retrieves incident object by incident key. |
| Get user by ID |
Retrieves the user's information for a given ID. |
| Reassign incident |
Reassign a given incident. |
| Resolve incident |
Mark a given incident as resolved. |
| Snooze incident |
Snooze a given incident by a certain time. |
Acknowledge incident
Acknowledge a given incident.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Incident
|
incidentId | True | string |
Select an incident |
|
Acknowledged by
|
userId | True | string |
Select a user |
Returns
An incident with incident property itself
- Body
- SingleIncident
Add note to incident
Add note to a given incident.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Incident
|
incidentId | True | string |
Select an incident |
|
Added by
|
userId | True | string |
Select a user |
|
Note
|
note | True | string |
Text for the note |
Returns
Response to AddNoteToIncident endpoint
- Body
- AddNoteResponse
Create incident
Creates a new incident for a given service identifiable by the integration key.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Service key
|
service_key | True | string |
Service integration key from PagerDuty |
|
Description
|
description | True | string |
Description of the incident |
Returns
A new incident
- Body
- NewIncident
Escalate incident
Use a given escalation policy on an incident.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Incident
|
incidentId | True | string |
Select an incident |
|
Escalated by
|
userId | True | string |
Select a user |
|
Escalation policy
|
policyId | True | string |
Select a policy |
Returns
An incident with incident property itself
- Body
- SingleIncident
Get incident
Retrieves incident object by incident key.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Incident
|
incident_key | True | string |
Incident key |
Returns
An incident
- Body
- Incident
Get user by ID
Retrieves the user's information for a given ID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User Id
|
userId | True | string |
Unique Id of the user. |
Returns
A PagerDuty user
- Body
- User
Reassign incident
Reassign a given incident.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Incident
|
incidentId | True | string |
Select an incident |
|
From user
|
userId | True | string |
Select a user |
|
To user
|
reassignUserId | True | string |
Select a user |
Returns
An incident with incident property itself
- Body
- SingleIncident
Resolve incident
Mark a given incident as resolved.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Incident
|
incidentId | True | string |
Select an incident |
|
Resolved by
|
userId | True | string |
Select a user |
Returns
An incident with incident property itself
- Body
- SingleIncident
Snooze incident
Snooze a given incident by a certain time.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Incident
|
incidentId | True | string |
Select an incident |
|
Snoozed by
|
userId | True | string |
Select a user |
|
Snooze
|
duration | True | integer |
The amount of time, in seconds, to snooze the incident |
Returns
An incident with incident property itself
- Body
- SingleIncident
Triggers
| When a note is added |
Triggers when a note is added to the given incident. |
| When an incident is acknowledged |
Triggers when an existing incident is acknowledged. |
| When an incident is assigned to a user |
Triggers when an incident is assigned to the given user. |
| When an incident is created |
Triggers when a new incident is created. |
| When an incident is resolved |
Triggers when an existing incident is resolved. |
When a note is added
Triggers when a note is added to the given incident.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Incident
|
incidentId | True | string |
Select an incident |
Returns
Response object for notes
- Body
- NotesResponse
When an incident is acknowledged
Triggers when an existing incident is acknowledged.
Returns
Response for a list of incidents
- Body
- IncidentsResponse
When an incident is assigned to a user
Triggers when an incident is assigned to the given user.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
User
|
userId | True | string |
Select a user |
Returns
Response for a list of incidents
- Body
- IncidentsResponse
When an incident is created
Triggers when a new incident is created.
Returns
Response for a list of incidents
- Body
- IncidentsResponse
When an incident is resolved
Triggers when an existing incident is resolved.
Returns
Response for a list of incidents
- Body
- IncidentsResponse
Definitions
IncidentsResponse
Response for a list of incidents
| Name | Path | Type | Description |
|---|---|---|---|
|
List of incidents
|
incidents | array of Incident |
List of incidents |
SingleIncident
An incident with incident property itself
| Name | Path | Type | Description |
|---|---|---|---|
|
incident
|
incident | Incident |
An incident |
Incident
An incident
| Name | Path | Type | Description |
|---|---|---|---|
|
Incident Id
|
id | string |
Incident Id |
|
Incident title
|
summary | string |
Incident title |
|
Incident detail url
|
html_url | string |
Incident detail url |
|
Create date
|
created_at | string |
Create date |
|
Current status
|
status | string |
Current status |
|
Incident Key
|
incident_key | string |
Incident Key |
|
service
|
service | Service |
A service |
|
Assigned User ID
|
assignedUserId | string |
The ID of the user assigned to this incident |
|
Last status change
|
last_status_change_at | string |
Last status change |
|
last_status_change_by
|
last_status_change_by | LastStatusChangeBy |
Represents the user or service that last changed an incident |
|
first_trigger_log_entry
|
first_trigger_log_entry | FirstTriggerLogEntry |
Log entry for when an incident is triggered |
|
escalation_policy
|
escalation_policy | EscalationPolicy |
The policy in place for escalating an incident |
|
Current urgency
|
urgency | string |
Current urgency |
NewIncident
A new incident
| Name | Path | Type | Description |
|---|---|---|---|
|
Key
|
incident_key | string |
Key |
Service
A service
| Name | Path | Type | Description |
|---|---|---|---|
|
Service Id
|
id | string |
Service Id |
LastStatusChangeBy
Represents the user or service that last changed an incident
FirstTriggerLogEntry
Log entry for when an incident is triggered
EscalationPolicy
The policy in place for escalating an incident
Object
User
A PagerDuty user
| Name | Path | Type | Description |
|---|---|---|---|
|
Name
|
name | string |
Name |
|
E-mail address
|
string |
E-mail address |
|
|
The preferred time zone name. If null, the account time zone will be used
|
time_zone | string |
The preferred time zone name. If null, the account time zone will be used |
|
User is billed
|
billed | boolean |
User is billed |
|
The user role
|
role | string |
The user role |
|
Description
|
description | string |
The user's bio |
|
Contact methods for the user
|
contact_methods | array of ContactMethod |
Contact methods for the user |
|
Notification rules for the user
|
notification_rules | array of NotificationRule |
Notification rules for the user |
|
Job title
|
job_title | string |
The user's job title |
|
Teams to which the user belongs
|
teams | array of Object |
Teams to which the user belongs |
|
List of incidents for this user
|
coordinated_incidents | array of Object |
List of incidents for this user |
|
User Id
|
id | string |
User Id |
|
A URL at which the entity is uniquely displayed in the Web app
|
html_url | string |
A URL at which the entity is uniquely displayed in the Web app |
ContactMethod
The method for contact
| Name | Path | Type | Description |
|---|---|---|---|
|
HTML URL
|
html_url | string |
A URL at which the entity is uniquely displayed in the web app |
NotificationRule
Notification rule
| Name | Path | Type | Description |
|---|---|---|---|
|
HTML URL
|
html_url | string |
A URL at which the entity is uniquely displayed in the web app |
NotesResponse
Response object for notes
AddNoteResponse
Response to AddNoteToIncident endpoint
| Name | Path | Type | Description |
|---|---|---|---|
|
user
|
user | UserResponse |
User response |
|
note
|
note | NoteResponse |
Note Response |
UserResponse
User response
| Name | Path | Type | Description |
|---|---|---|---|
|
User Id
|
id | string |
User Id |
NoteResponse
Note Response
| Name | Path | Type | Description |
|---|---|---|---|
|
Unique identifier of the user
|
id | string |
Unique identifier of the user |
|
user
|
user | UserResponse |
User response |
|
Note content
|
content | string |
Note content |
|
Date and time the note was created
|
created_at | string |
Date and time the note was created |