Skip to main content
ZStack
Alerting & Response/On-Call

CreateEscalationPolicy

Create a new escalation policy with rules and notification targets

POST/api/v1/oncall/escalation-policies

Operation ID

CreateEscalationPolicy

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Body Fields

  • name
    StringRequired

    Name of the escalation policy to create

    Example: Critical Alert Policy

  • description
    StringRequired

    Description of the escalation policy

    Example: Escalation policy for P0 incidents

  • rules
    ListRequired

    Ordered list of escalation rules for this policy

    Example: (nested array)

    • level
      Integer

      Escalation level number (starting from 1)

      Example: 1

    • targets
      List

      List of user or group IDs to notify at this escalation level

      Example: item1,item2

    • timeout
      String

      Duration to wait before escalating to the next level

      Example: 15m

    • notifyMethods
      List

      Notification channels used at this escalation level

      Example: item1,item2

  • repeatCount
    IntegerRequired

    Number of times to repeat the full escalation cycle if unacknowledged

    Example: 3

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Unique identifier of the escalation policy

    Example: pol-11223344

  • name
    String

    Human-readable name of the escalation policy

    Example: Critical Alert Policy

  • description
    String

    Description of when this escalation policy is used

    Example: Escalation policy for P0 incidents

  • rules
    List

    Ordered list of escalation rules in this policy

    Example: (nested array)

    • level
      Integer

      Escalation level number (starting from 1)

      Example: 1

    • targets
      List

      List of user or group IDs to notify at this escalation level

      Example: item1,item2

    • timeout
      String

      Duration to wait before escalating to the next level

      Example: 15m

    • notifyMethods
      List

      Notification channels used at this escalation level

      Example: item1,item2

  • repeatCount
    Integer

    Number of times to repeat the full escalation cycle if unacknowledged

    Example: 3

  • createDate
    String

    Timestamp when the escalation policy was created

    Example: 2026-01-15T08:00:00Z

  • lastOpDate
    String

    Timestamp of the last modification to the escalation policy

    Example: 2026-01-15T08:00:00Z