Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
      1. On-call schedule
      2. On-call schedule events
      3. On-call schedule rotations
      4. Escalation policies
      5. Escalation policy groups
        1. List escalation policy groups GET
        2. Get escalation policy group GET
        3. List policies in group GET
        4. Create escalation policy group POST
        5. Update escalation policy group PATCH
        6. Remove escalation policy group DELETE
      6. Severities
      7. Severity groups
      8. Incidents
      9. Comments
    6. Status pages
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Create escalation policy group

Returns either a newly created escalation policy group, or validation errors.

POST https://incidents.betterstack.com/api/v2/policy-groups

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

team_name
string

Required if using global API token to specify the team which should own the resource

name
required string

The name of the group that you can see in the dashboard.

sort_index
integer

The position of the group in your list of escalation policy groups, lower values first. position is accepted as an alias.

201

Returns newly escalation policy group

Response body

{
  "data": {
    "id": "1234567",
    "type": "policy_group",
    "attributes": {
      "name": "Example",
      "sort_index": null,
      "created_at": "2024-07-26T15:07:46.350Z",
      "updated_at": "2024-07-26T15:07:46.350Z",
      "team_name": "Test team"
    }
  }
}

Example cURL

Example
curl --request POST \
  --url https://incidents.betterstack.com/api/v2/policy-groups \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "Example"
}'


Previous article

List policies in a group

Next article

Update escalation policy group