---
title: "Create a new incident."
method: POST
path: "/v1/status-pages/incidents"
tags: ["Status Page Incidents"]
deprecated: true
---

# Create a new incident.

`POST /v1/status-pages/incidents`

## Request

- Base URL: `https://api.checklyhq.com`
- URL: `https://api.checklyhq.com/v1/status-pages/incidents`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v1/status-pages/incidents/post.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Creates a new incident.

Use the [Status Pages v3 API](/api-reference/status-pages-v3/list-v3-status-pages) for new integrations.

## Headers

- `x-checkly-account` string: Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

## Request body

- CreateStatusPageV2Incident
  - `id` string
  - `created_at` string, date
  - `updated_at` string, date
  - `lastUpdateStatus` 'INVESTIGATING' | 'IDENTIFIED' | 'MONITORING' | 'RESOLVED'
  - `name` string, required
  - `severity` 'CRITICAL' | 'MAJOR' | 'MEDIUM' | 'MINOR', required
  - `services` IncidentService[], required
    - `name` string, required
    - `id` string, required
    - `accountId` string, required
    - `created_at` string, date
    - `updated_at` string, date, nullable
  - `duration` integer, nullable
  - `incidentUpdates` StatusPageV2IncidentUpdate[], required
    - `id` string
    - `description` string, required
    - `status` 'INVESTIGATING' | 'IDENTIFIED' | 'MONITORING' | 'RESOLVED'
    - `publicIncidentUpdateDate` string, date-time
    - `created_at` string, date
    - `notifySubscribers` boolean

## Response `201`

Created

- StatusPageV2Incident
  - `name` string, required
  - `severity` 'CRITICAL' | 'MAJOR' | 'MEDIUM' | 'MINOR', required
  - `id` string, required
  - `services` StatusPageV2Service[], required
    - `name` string, required
    - `id` string, required
    - `accountId` string, required
    - `created_at` string, date, required
    - `updated_at` string, date, nullable
  - `incidentUpdates` StatusPageV2IncidentUpdateWithId[], required
    - `description` string, required
    - `status` 'INVESTIGATING' | 'IDENTIFIED' | 'MONITORING' | 'RESOLVED'
    - `publicIncidentUpdateDate` string, date-time
    - `notifySubscribers` boolean
    - `id` string, required
    - `created_at` string, date, required
  - `lastUpdateStatus` 'INVESTIGATING' | 'IDENTIFIED' | 'MONITORING' | 'RESOLVED', required
  - `duration` integer, nullable
  - `created_at` string, date, required
  - `updated_at` string, date

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

## Changes

- **2026-10-31** `bc90d1bfa738`: 3 info
  - the `publicIncidentUpdateDate` request property default value changed from `2026-10-05T01:01:23.752Z` to `2026-10-29T19:59:23.378Z`
  - added the optional property `errorCode` to the response with the `403` status
  - the `publicIncidentUpdateDate` response's property default value changed from `2026-10-05T01:01:23.666Z` to `2026-10-29T19:59:23.350Z` for the status `201`
- **2026-10-07** `aba5d34c749b`: 3 info
  - endpoint deprecated
  - the `publicIncidentUpdateDate` request property default value changed from `2026-08-11T02:46:47.038Z` to `2026-10-05T01:01:23.752Z`
  - the `publicIncidentUpdateDate` response's property default value changed from `2026-08-11T02:46:46.919Z` to `2026-10-05T01:01:23.666Z` for the status `201`
- **2026-08-12** `87d29dc7b4fe`: 2 info
  - the `publicIncidentUpdateDate` request property default value changed from `2026-08-03T03:10:39.274Z` to `2026-08-11T02:46:47.038Z`
  - the `publicIncidentUpdateDate` response's property default value changed from `2026-08-03T03:10:39.158Z` to `2026-08-11T02:46:46.919Z` for the status `201`
- **2026-08-05** `9e903da4f3da`: 2 info
  - the `publicIncidentUpdateDate` request property default value changed from `2026-07-13T03:11:27.207Z` to `2026-08-03T03:10:39.274Z`
  - the `publicIncidentUpdateDate` response's property default value changed from `2026-07-13T03:11:27.141Z` to `2026-08-03T03:10:39.158Z` for the status `201`
- …earlier changes not shown

[Operation history](https://skmtc.dev/checklyhq/apis/checkly-public-api/changes/v1/status-pages/incidents/post.md)

---

[API](https://skmtc.dev/checklyhq/apis/checkly-public-api.md) - [All operations](https://skmtc.dev/checklyhq/apis/checkly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checklyhq/apis/checkly-public-api/revisions/bc90d1bfa738?raw)