Skip to main content
POST
/
v1
/
status-pages
/
incidents
Create a new incident.
curl --request POST \
  --url https://api.checklyhq.com/v1/status-pages/incidents \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "<string>",
  "created_at": "2023-12-25",
  "updated_at": "2023-12-25",
  "lastUpdateStatus": "INVESTIGATING",
  "name": "<string>",
  "severity": "CRITICAL",
  "services": [
    {
      "name": "<string>",
      "id": "<string>",
      "accountId": "<string>",
      "created_at": "2023-12-25",
      "updated_at": "2023-12-25",
      "checks": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ]
    }
  ],
  "incidentUpdates": [
    {
      "id": "<string>",
      "description": "<string>",
      "status": "INVESTIGATING",
      "publicIncidentUpdateDate": "2025-10-11T02:28:38.203Z",
      "created_at": "2023-12-25",
      "notifySubscribers": false
    }
  ]
}'
{
  "name": "<string>",
  "severity": "CRITICAL",
  "id": "<string>",
  "services": [
    {
      "name": "<string>",
      "id": "<string>",
      "accountId": "<string>",
      "created_at": "2023-12-25",
      "updated_at": "2023-12-25",
      "checks": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ]
    }
  ],
  "incidentUpdates": [
    {
      "description": "<string>",
      "status": "INVESTIGATING",
      "publicIncidentUpdateDate": "2025-10-11T02:28:38.145Z",
      "notifySubscribers": false,
      "id": "<string>",
      "created_at": "2023-12-25"
    }
  ],
  "lastUpdateStatus": "INVESTIGATING",
  "created_at": "2023-12-25",
  "updated_at": "2023-12-25"
}

Authorizations

​
Authorization
string
header
required

The Checkly Public API uses API keys to authenticate requests. You can get the API Key here. Your API key is like a password: keep it secure! Authentication to the API is performed using the Bearer auth method in the Authorization header and using the account ID. For example, set Authorization header while using cURL: curl -H "Authorization: Bearer [apiKey]" "X-Checkly-Account: [accountId]"

Headers

​
x-checkly-account
string

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Body

application/json
​
name
string
required
Maximum length: 255
​
severity
enum<string>
required
Available options:
CRITICAL,
MAJOR,
MEDIUM,
MINOR
​
services
object[]
required
Minimum length: 1
​
incidentUpdates
object[]
required
​
id
string
​
created_at
string<date>
​
updated_at
string<date>
​
lastUpdateStatus
enum<string>
Available options:
INVESTIGATING,
IDENTIFIED,
MONITORING,
RESOLVED

Response

Created

​
name
string
required
Maximum length: 255
​
severity
enum<string>
required
Available options:
CRITICAL,
MAJOR,
MEDIUM,
MINOR
​
id
string
required
​
services
object[]
required
​
incidentUpdates
object[]
required
​
lastUpdateStatus
enum<string>
required
Available options:
INVESTIGATING,
IDENTIFIED,
MONITORING,
RESOLVED
​
created_at
string<date>
required
​
updated_at
string<date>
⌘I