Create a new incident

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

POST https://betteruptime.com/api/v2/incidents

Headers

Authorization
required string
Content_Type
string

Body parameters

requester_email
string
name
string
summary
string
description
string
call
boolean
sms
boolean
email
boolean
push
boolean
team_wait
integer
policy_id
string
201

Response body

{
  "data": {
    "id": "123456789",
    "type": "incident",
    "attributes": {
      "name": "betteruptime homepage",
      "url": "https://betteruptime.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,
      "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,
      "escalation_policy_id": null,
      "call": true,
      "sms": true,
      "email": true,
      "push": true
    },
    "relationships": {
      "monitor": {
        "data": {
          "id": "2",
          "type": "monitor"
        }
      }
    }
  }
}
404

Example cURL

curl --request POST \
  --url https://betteruptime.com/api/v2/incidents \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"summary": "Test incident", "requester_email": "[email protected]", "description": "No need to worry, everything is fine, this is just testing the great Better Uptime API."}'
Copied!