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

Operation ID:

AcknowledgeIncident

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

Operation ID:

AddNoteToIncident

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

Operation ID:

CreateIncident

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

Operation ID:

EscalateIncident

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

Operation ID:

GetIncidentByKey

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

Operation ID:

GetUser

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

Operation ID:

ReassignIncident

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

Operation ID:

ResolveIncident

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

Operation ID:

SnoozeIncident

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

Operation ID:

OnNewIncidentNote

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

Operation ID:

OnIncidentAcknowledged

Triggers when an existing incident is acknowledged.

Returns

Response for a list of incidents

Body

IncidentsResponse

When an incident is assigned to a user

Operation ID:

OnIncidentAssigned

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

Operation ID:

OnNewIncidentCreated

Triggers when a new incident is created.

Returns

Response for a list of incidents

Body

IncidentsResponse

When an incident is resolved

Operation ID:

OnIncidentResolved

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

• Decrease incident resolution times with PagerDuty and Microsoft Flow