For AI agents and assistants: visit https://docs.pagerduty.com/llms.txt for the index.

Create an escalation policy

Creates a new escalation policy. At least one escalation rule must be provided.

Escalation policies define which user should be alerted at which time.

For more information see the API Concepts Document

Scoped OAuth requires: escalation_policies.write

Authorization

api_key

Authorization<token>

The API Key with format Token token=<API_KEY>

In: header

Header Parameters

Accept*string

The Accept header is used as a versioning header.

Default"application/vnd.pagerduty+json;version=2"

From?string

The email address of a valid user associated with the account making the request. This is optional, and is only used for change tracking.

Formatemail

Request Body

application/json

The escalation policy to be created.

TypeScript Definitions

Use the request body type in TypeScript.

escalation_policy*

Response Body

`application/json`

curl -X POST "https://api.pagerduty.com/escalation_policies" \  -H "Accept: application/vnd.pagerduty+json;version=2" \  -H "Content-Type: application/json" \  -d '{    "escalation_policy": {      "type": "escalation_policy",      "name": "Engineering Escalation Policy",      "escalation_rules": [        {          "escalation_delay_in_minutes": 30,          "targets": [            {              "id": "PEYSGVF",              "type": "user_reference"            }          ],          "escalation_rule_assignment_strategy": {            "type": "round_robin"          }        }      ],      "services": [        {          "id": "PIJ90N7",          "type": "service_reference"        }      ],      "num_loops": 2,      "on_call_handoff_notifications": "if_has_services",      "teams": [        {          "id": "PQ9K7I8",          "type": "team_reference"        }      ],      "description": "Here is the ep for the engineering team."    }  }'

{  "escalation_policy": {    "id": "PT20YPA",    "type": "escalation_policy",    "summary": "Engineering Escalation Policy",    "on_call_handoff_notifications": "if_has_services",    "self": "https://api.pagerduty.com/escalation_policies/PT20YPA",    "html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA",    "name": "Engineering Escalation Policy",    "escalation_rules": [      {        "id": "PT20YPA",        "escalation_delay_in_minutes": 22,        "targets": [          {            "id": "PXPGF42",            "summary": "Earline Greenholt",            "type": "user_reference",            "self": "https://api.pagerduty.com/users/PXPGF42",            "html_url": "https://subdomain.pagerduty.com/users/PXPGF42"          },          {            "id": "PI7DH85",            "summary": "Daily Engineering Rotation",            "type": "schedule_reference",            "self": "https://api.pagerduty.com/schedules/PI7DH85",            "html_url": "https://subdomain.pagerduty.com/schedules/PI7DH85"          }        ]      }    ],    "services": [      {        "id": "PIJ90N7",        "type": "service_reference",        "summary": "My Mail Service",        "self": "https://api.pagerduty.com/services/PIJ90N7",        "html_url": "https://subdomain.pagerduty.com/service-directory/PIJ90N7"      }    ],    "num_loops": 2,    "teams": [      {        "id": "PQ9K7I8",        "type": "team_reference",        "summary": "Engineering",        "self": "https://api.pagerduty.com/teams/PQ9K7I8",        "html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8"      }    ]  }}

Create an escalation policy

Authorization

Header Parameters

Request Body

Response Body

201application/json

400application/json

401application/json

402application/json

403application/json

429application/json

Developer Agreement

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`