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/ |
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Not shareable |
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 |
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 30 | 60 seconds |
Frequency of trigger polls | 1 | 30 seconds |
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 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 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
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
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
Retrieves incident object by incident key.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
Incident
|
incident_key | True | string |
Incident key |
Returns
An incident
- Body
- Incident
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 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
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 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
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. |
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
Triggers when an existing incident is acknowledged.
Returns
Response for a list of incidents
- Body
- IncidentsResponse
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
Triggers when a new incident is created.
Returns
Response for a list of incidents
- Body
- IncidentsResponse
Triggers when an existing incident is resolved.
Returns
Response for a list of incidents
- Body
- IncidentsResponse
Response for a list of incidents
Name | Path | Type | Description |
---|---|---|---|
List of incidents
|
incidents | array of Incident |
List of incidents |
An incident with incident property itself
Name | Path | Type | Description |
---|---|---|---|
incident
|
incident | Incident |
An 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 |
A new incident
Name | Path | Type | Description |
---|---|---|---|
Key
|
incident_key | string |
Key |
A service
Name | Path | Type | Description |
---|---|---|---|
Service Id
|
id | string |
Service Id |
Represents the user or service that last changed an incident
Log entry for when an incident is triggered
The policy in place for escalating an incident
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 |
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 |
Notification rule
Name | Path | Type | Description |
---|---|---|---|
HTML URL
|
html_url | string |
A URL at which the entity is uniquely displayed in the web app |
Response object for notes
Response to AddNoteToIncident endpoint
Name | Path | Type | Description |
---|---|---|---|
user
|
user | UserResponse |
User response |
note
|
note | NoteResponse |
Note Response |
User response
Name | Path | Type | Description |
---|---|---|---|
User Id
|
id | string |
User Id |
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 |