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
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

Creating a connection

To connect your account, you will need the following information:

Name Type Description
PagerDuty API Key securestring

PagerDuty API Key

Throttling Limits

Name Calls Renewal Period
API calls per connection3060 seconds
Frequency of trigger polls130 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

Body
Incident

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

Body
Incident

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

Body
Incident

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

Body
Incident

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

Body
Incident

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

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

ContactMethod

The method for contact

Name Path Type Description
html_url
html_url Object

NotificationRule

Notification rule

Name Path Type Description
html_url
html_url Object

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