---
title: "Create an incident"
method: POST
path: "/incidents/create"
tags: ["Incidents"]
---

# Create an incident

`POST /incidents/create`

## Request

- Base URL: `https://api.spike.sh`
- URL: `https://api.spike.sh/incidents/create`
- Auth: none declared. Required headers: `x-api-key`, `x-team-id`
- TypeScript: <https://skmtc.dev/spike/apis/spike-sh-api/docs/incidents/create/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates an incident and sends alerts

## Headers

- `x-api-key` string, required
- `x-team-id` string, required

## Request body

- object
  - `title` string, required: Incident title
  - `metadata` string: Additional metadata
  - `escalation` string, required: Escalation ID
  - `integration` string, required: Integration token
  - `priority` 'p1' | 'p2' | 'p3' | 'p4' | 'p5': Priority level
  - `severity` 'sev1' | 'sev2' | 'sev3': Severity level

## Response `200`

Incident created successfully

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/spike/apis/spike-sh-api.md) - [All operations](https://skmtc.dev/spike/apis/spike-sh-api/llms.txt) - [OpenAPI document](https://skmtc.dev/spike/apis/spike-sh-api/revisions/6854629119aa?raw)