> ## Documentation Index > Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt > Use this file to discover all available pages before exploring further. # Create 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](https://developer.pagerduty.com/api-reference/a47605517c19a-api-concepts#escalation-policies). External Documentation To learn more, visit the [PagerDuty documentation](https://developer.pagerduty.com/api-reference/77515ca391014-create-an-escalation-policy). ## Basic Parameters
| Parameter | Description | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Escalation Policy Description | Escalation policy description. | | Escalation Policy Name | The name of the escalation policy. | | Escalation Policy Num Loops | The number of times the escalation policy will repeat after reaching the end of its escalation. | | Escalation Policy Summary | A short-form, server-generated string that provides succinct, important information about an object suitable for primary labeling of an entity in a client. In many cases, this will be identical to `name`, though it is not intended to be an identifier. | | Escalation Rules | The escalation rules for the escalation policy.
An array of rules containing the following rules format:
- `escalation_delay_in_minutes`:
The number of minutes before an unacknowledged incident escalates away from this rule.
This field is required.
- `targets`:
The targets an incident should be assigned to upon reaching this rule. The number of items allowed are `>=` 1
`<=` 10 items.
This field is required.
- `escalation_rule_assignment_strategy`:
The strategy used to assign the escalation rule to an incident.
Allowed values:
- `round_robin`
- `assign_to_everyone` | | From | The email address of a valid user associated with the account making the request. This is optional, and is only used for change tracking. |
## Advanced Parameters
| Parameter | Description | | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Escalation Policy On Call Handoff Notifications | Determines how on call handoff notifications will be sent for users on the escalation policy. Defaults to "if\_has\_services". | | Escalation Policy Services | An array of escalation policy services objects.

For example:
\[
  \{
    "id": "PIJ90N7",
    "type": "service\_reference"
  }
]
For more information about the `Escalation Policy Services` parameter, visit [PagerDuty API documentation](https://developer.pagerduty.com/api-reference/77515ca391014-create-an-escalation-policy). | | Escalation Policy Teams | Teams associated with the policy. Account must have the `teams` ability to use this parameter. |
## Example Output ```json theme={"dark"} { "summary": "Response Example", "value": { "escalation_policy": { "escalation_rules": [ { "escalation_delay_in_minutes": 22, "id": "PT20YPA", "targets": [ { "html_url": "https://subdomain.pagerduty.com/users/PXPGF42", "id": "PXPGF42", "self": "https://api.pagerduty.com/users/PXPGF42", "summary": "Earline Greenholt", "type": "user_reference" }, { "html_url": "https://subdomain.pagerduty.com/schedules/PI7DH85", "id": "PI7DH85", "self": "https://api.pagerduty.com/schedules/PI7DH85", "summary": "Daily Engineering Rotation", "type": "schedule_reference" } ] } ], "html_url": "https://subdomain.pagerduty.com/escalation_policies/PT20YPA", "id": "PT20YPA", "name": "Engineering Escalation Policy", "num_loops": 2, "on_call_handoff_notifications": "if_has_services", "self": "https://api.pagerduty.com/escalation_policies/PT20YPA", "services": [ { "html_url": "https://subdomain.pagerduty.com/services/PIJ90N7", "id": "PIJ90N7", "self": "https://api.pagerduty.com/services/PIJ90N7", "summary": "My Mail Service", "type": "service_reference" } ], "summary": "Engineering Escalation Policy", "teams": [ { "html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8", "id": "PQ9K7I8", "self": "https://api.pagerduty.com/teams/PQ9K7I8", "summary": "Engineering", "type": "team_reference" } ], "type": "escalation_policy" } } } ``` ## Workflow Library Example [Create Escalation Policy with Pagerduty and Send Results Via Email](https://library.blinkops.com/workflows/create-escalation-policy-with-pagerduty-and-send-results-via-email)
Workflow Library Preview this Workflow on desktop