Try it free

Actions for PagerDuty Connector

  • Latest Dynatrace
  • Reference
  • 7-min read

The following workflow actions are available for PagerDuty Connector PagerDuty. Each action corresponds to an endpoint of the PagerDuty API.

For details on creating workflows, refer to Build workflows.

Create an incident

Creates an incident in your PagerDuty environment for a service. An incident represents a problem or an issue that needs to be addressed and resolved.

Use other actions to obtain the necessary input.

Inputs

FieldDescriptionRequired

Connection

The preconfigured connection to your PagerDuty environment.

Required

From

The email address of a valid PagerDuty user associated with the account making the request.

Required

Title

A description of the nature, symptoms, cause, or effect of the incident.

Required

Service ID

The ID of the service in your PagerDuty environment.

Required

Priority ID

The ID of the priority to associate with the incident.

Optional

Urgency

The urgency of the incident, high or low.

Optional

Additional incident details

A description of the incident.

Optional

Assignee user ID

The user to assign the incident to. It cannot be specified if an escalation policy ID is given.

Optional

Escalation policy ID

The escalation policy to use for assigning the incident. It cannot be specified if an assignee user ID is given.

Optional

Conference number

The phone number of the conference call for the conference bridge.

Optional

Conference URL

The URL for the conference bridge, such as a link to a web conference or Slack channel.

Optional

Incident key

A unique identifier for this incident. For most use cases this is the Dynatrace event ID.

Optional

Output

The Create an incident action returns the response of the Create an incident PagerDuty API endpoint. The result contains a single incident object that describes the created incident.

PropertyDescription

incident

The created incident, including its id, incident_number, title, status, urgency, created_at, and the referenced service, escalation_policy, and priority.

This result can be used as inputs for other workflow actions via workflow expressions.

List all of the on-calls

Retrieves a list of users that are on call.

Inputs

FieldDescriptionRequired

Connection

The preconfigured connection to your PagerDuty environment.

Required

Limit

Pagination - number of results per page.

Optional

Offset

Pagination - offset to start results.

Optional

Total

Pagination - set to true to populate the total field in the response.

Optional

Earliest

Set to true to return only the earliest on-call for each combination of escalation policy, escalation level, and user.

Optional

Since

The start of the time range as an ISO8601 date-time.

Optional

Until

The end of the time range as an ISO8601 date-time.

Optional

Time zone

The time zone used in results. By default, the time zone of the account.

Optional

Escalation policy IDs

A comma separated list of escalation policy IDs to filter the on-calls by.

Optional

Schedule IDs

A comma separated list of schedule IDs to filter the on-calls by.

Optional

User IDs

A comma separated list of user IDs to filter the on-calls by.

Optional

Include

A comma separated list of additional details to include. Supported values: escalation_policies, users, and schedules.

Optional

Output

The List on-calls action returns the response of the List all of the on-calls PagerDuty API endpoint.

PropertyDescription

oncalls

An array of on-call entries. Each entry references the user, escalation_policy, schedule, escalation_level, and the start and end of the on-call period.

limit, offset, more, total

The pagination fields that describe the returned page of results.

This result can be used as inputs for other workflow actions via workflow expressions.

List escalation policies

Retrieves a list of escalation policies which determine what user or schedule will be notified and in what order when an incident is triggered.

Inputs

FieldDescriptionRequired

Connection

The preconfigured connection to your PagerDuty environment.

Required

Limit

Pagination - number of results per page.

Optional

Offset

Pagination - offset to start results.

Optional

Query

Filters results to include only escalation policies with names matching the query.

Optional

Total

Pagination - set to true to populate the total field in the response.

Optional

Include

A comma separated list of additional details to include. Supported values: contact_methods, notification_rules, teams, and subdomains.

Optional

Sort by

Specifies which field is used to sort results. Supported values: name, name:asc, or name:desc.

Optional

Team IDs

A comma separated list of team IDs. Only results related to these teams will be returned.

Optional

User IDs

A comma separated list of user IDs. Only escalation policies targeting these users will be returned.

Optional

Output

The List escalation policies action returns the response of the List escalation policies PagerDuty API endpoint.

PropertyDescription

escalation_policies

An array of escalation policies. Each entry includes its id, name, description, escalation_rules, and the referenced services and teams.

limit, offset, more, total

The pagination fields that describe the returned page of results.

This result can be used as inputs for other workflow actions via workflow expressions.

List priorities

Retrieves an ordered list of priorities, representing the importance of an incident (ordered most to least severe).

Inputs

FieldDescriptionRequired

Connection

The preconfigured connection to your PagerDuty environment.

Required

Limit

Pagination - number of results per page.

Optional

Offset

Pagination - offset to start results.

Optional

Total

Pagination - set to true to populate the total field in the response.

Optional

Output

The List priorities action returns the response of the List priorities PagerDuty API endpoint.

PropertyDescription

priorities

An array of priorities, ordered from the most to the least severe. Each entry includes its id, name, and description.

limit, offset, more, total

The pagination fields that describe the returned page of results.

This result can be used as inputs for other workflow actions via workflow expressions.

List services

Lists PagerDuty services. A service represents an application, component, or team to which you want to map the incident.

Inputs

FieldDescriptionRequired

Connection

The preconfigured connection to your PagerDuty environment.

Required

Limit

Pagination - number of results per page.

Optional

Offset

Pagination - offset to start results.

Optional

Total

Pagination - set to true to populate the total field in the response.

Optional

Query

Filters results to include only services with names matching the query.

Optional

Include

A comma separated list of additional details to include. Supported values: escalation_policies, teams, integrations, and auto_pause_notifications_parameters.

Optional

Sort by

Specifies which field is used to sort results. Supported values: name, name:asc, or name:desc.

Optional

Team IDs

A comma separated list of team IDs. Only results related to these teams will be returned.

Optional

Time zone

The time zone used in results. By default, the time zone of the account.

Optional

Output

The List services action returns the response of the List services PagerDuty API endpoint.

PropertyDescription

services

An array of services. Each entry includes its id, name, description, status, and the referenced escalation_policy and teams.

limit, offset, more, total

The pagination fields that describe the returned page of results.

This result can be used as inputs for other workflow actions via workflow expressions.

List users

List all users of your PagerDuty environment.

Inputs

FieldDescriptionRequired

Connection

The preconfigured connection to your PagerDuty environment.

Required

Limit

Pagination - number of results per page.

Optional

Offset

Pagination - offset to start results.

Optional

Total

Pagination - set to true to populate the total field in the response.

Optional

Query

Filters results to include only users with names matching the query.

Optional

Include

A comma separated list of additional details to include. Supported values: services, teams, and targets.

Optional

Team IDs

A comma separated list of team IDs. Only results related to these teams will be returned.

Optional

Output

The List users action returns the response of the List users PagerDuty API endpoint.

PropertyDescription

users

An array of users. Each entry includes its id, name, email, role, time_zone, and the referenced teams.

limit, offset, more, total

The pagination fields that describe the returned page of results.

This result can be used as inputs for other workflow actions via workflow expressions.

Related topics

  • PagerDuty Connector
  • Set up PagerDuty Connector
Related tags
Dynatrace Platform