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. AI SRE investigations
    3. Post mortems
    4. Metadata & Catalog
    5. Screening alerts
    6. 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
      6. Severities
        1. List severities GET
        2. Get severity GET
        3. Create severity POST
        4. Update severity PATCH
        5. Remove severity DELETE
      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 severity

Returns either a newly created severity, or validation errors.

POST https://incidents.betterstack.com/api/v2/urgencies

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 this severity.

sms
required boolean

Whether to send SMS when a new incident is created.

call
required boolean

Whether to call when a new incident is created.

email
boolean

Whether to send e-mail when a new incident is created. Defaults to true.

push
boolean

Whether to send push notification when a new incident is created. Defaults to true.

critical_alert
boolean

Whether to send a critical push notification that ignores the mute switch and Do Not Disturb mode. Defaults to false.

urgency_group_id
integer

The ID of the severity group to add this severity to.

201

Returns newly created severity. Each team member can override the severity's alert channels for themselves in their Alerts settings.

Response body

{
  "data": {
    "id": "789",
    "type": "urgency",
    "attributes": {
      "name": "New severity",
      "team_name": "Test team",
      "sms": false,
      "call": true,
      "email": false,
      "push": true,
      "critical_alert": false,
      "urgency_group_id": null
    }
  }
}

Example cURL

Example
curl -X "POST" "https://incidents.betterstack.com/api/v2/urgencies/" \
-H "Authorization: Bearer $TOKEN" \
-H 'Content-Type: application/json; charset=utf-8' \
-d $'{ "name": "New severity", "sms": false, "call": true, "email": false, "push": true }'


Previous article

Get severity

Next article

Update severity