Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  4. On-call scheduling and alerting
    1. Get started
    2. Sending alerts to Slack ↗
    3. Connecting external calendars
    4. Advanced guide
  5. Incidents
    1. Get started
    2. Advanced guide
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Integrations
    1. Integrating with Better Stack
  8. Team and account management
    1. Team management
    2. Account settings
    3. Audit logs
    4. Migrating to pay as you go
  9. Uptime API
    1. Get an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
      1. On-call calendar
      2. On-call calendar events
      3. On-call calendar rotations
      4. Escalation policies
      5. Escalation policy groups
      6. Severities
      7. Severity groups
      8. Incidents
        1. List incidents GET
        2. Get incident GET
        3. List incident timeline GET
        4. Create incident POST
        5. Acknowledge incident POST
        6. Resolve incident POST
        7. Remove incident DELETE
        8. Response params
      9. Comments
    5. Status pages
    6. Metadata
    7. Integrations

Create incident

This will create a new incident and alert the current on-call person.

POST https://uptime.betterstack.com/api/v3/incidents

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

requester_email
string

E-mail of the user who requested the incident

name
string

Short name of the incident

summary
string

Brief summary of the incident

description
string

Full description of the incident

call
boolean

Should we call the on-call person?

sms
boolean

Should we send an SMS to the on-call person?

email
boolean

Should we send an email to the on-call person?

push
boolean

Should we send a push notification to the on-call person?

team_wait
integer

How long to wait before escalating the incident alert to the team. Leave blank to disable escalating to the entire team. In seconds.

policy_id
string

The ID of the escalation policy with which you'd like to escalate this incident

metadata
object

An object with metadata keys as the object keys and arrays of metadata values as object values. See the metadata API response params page for details about metadata value attributes.

201

The incident was succesfully created

Response body

{
  "data": {
    "id": "123456789",
    "type": "incident",
    "attributes": {
      "name": "uptime homepage",
      "url": "https://uptime.betterstack.com/",
      "http_method": "get",
      "cause": "Status 500",
      "incident_group_id": null,
      "started_at": "2020-03-09T17:37:56.662Z",
      "acknowledged_at": null,
      "acknowledged_by": null,
      "resolved_at": null,
      "resolved_by": null,
      "team_name": "Testing team",
      "response_content": "\n404 Not Found\n\nNot Found\nThe requested URL /fail was not found on this server.\n",
      "response_options": "{}",
      "regions": [
        "us",
        "eu",
        "as",
        "au"
      ],
      "response_url": null,
      "screenshot_url": null,
      "origin_url": null,
      "escalation_policy_id": null,
      "call": true,
      "sms": true,
      "email": true,
      "push": true
    },
    "relationships": {
      "monitor": {
        "data": {
          "id": "2",
          "type": "monitor"
        }
      }
    }
  }
}
404

Authentication failed

Example cURL

Example Example with metadata 
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/incidents \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "summary": "Test incident",
    "requester_email": "my-great-email@example.com",
    "description": "No need to worry, everything is fine, this is just testing the great Uptime API."
  }'
curl --request POST \
  --url https://uptime.betterstack.com/api/v3/incidents \
  --header "Authorization: Bearer $TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{
    "summary": "Test incident",
    "requester_email": "my-great-email@example.com",
    "description": "No need to worry, everything is fine, this is just testing the great Uptime API.",
    "metadata": {
      "Affected Services": [
        {
          "value": "Homepage"
        },
        {
          "value": "Login"
        }
      ],
      "On-call Calendar": [
        {
          "type": "Schedule",
          "name": "Primary calendar"
        }
      ]
    }
  }'

Previous article

List incident timeline

Next article

Acknowledge incident