---
title: "Create a new incident"
method: POST
path: "/api-public/v1/incidents"
tags: ["Incidents"]
---

# Create a new incident

`POST /api-public/v1/incidents`

Create a new incident.

This call replicates the function of our
<a href="https://help.victorops.com/knowledge-base/manual-incident-creation/">manual incident creation process</a>.
Monitoring tools and custom integrations
should be configured using our
<a href="https://help.victorops.com/knowledge-base/victorops-restendpoint-integration/">REST Endpoint</a>.

The "isMultiResponder" option will require a response from each paged user and escalation policy before
paging is stopped. The option is available only to Enterprise accounts.

This API may be called a maximum of 2 times per second.

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Request body

- CreateIncidentRequest
  - `summary` string, required
  - `details` string, required
  - `userName` string, required
  - `targets` IncidentTarget[], required
    - `type` 'User' | 'EscalationPolicy', required — Type of target
    - `slug` string, required — User name or escalation policy slug
  - `isMultiResponder` boolean

## Response `200`

Information about the incident created

- Note — unresolved $ref

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — Path not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/victorops/apis/victorops-api.md) · [All operations](https://skmtc.net/victorops/apis/victorops-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/victorops/victorops-api/revisions/7a7391256058/schema)