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)
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

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

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

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

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

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

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

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

When an incident is acknowledged

Triggers when an existing incident is acknowledged.

Returns

Response for a list of incidents

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

When an incident is created

Triggers when a new incident is created.

Returns

Response for a list of incidents

When an incident is resolved

Triggers when an existing incident is resolved.

Returns

Response for a list of incidents

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
email 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

Using this Connector