# Create an Incident

Creates a new Incident. During creation, first Incident Update for this Incident will also be created.

Endpoint: POST /hubs/{subdomain}/incidents
Version: 3.0-R1
Security: ApiKeyAuth

## Path parameters:

  - `subdomain` (string, required)
    Unique subdomain of requested Hub.

## Query parameters:

  - `api_version` (string)
    Api version
    Enum: "V3-R1"

## Request fields (application/json):

  - `title` (string, required)
    Title of event. Can contain only plain text. HTML tags and other forms of formatting are not allowed.
    Example: "Title of the event"

  - `start_time` (string,null, required)
    Timestamp of event start. Can't be in future. ISO8601 formatted time (UTC).
    Example: "2020-09-01T08:29:00Z"

  - `incident_type` (string, required)
    Type of Incident Update. Exact meaning may depend on use case and there is just one restriction: resolved can't be used as type of a first (by start_time) Incident Update.
    Enum: "investigating", "identified", "monitoring", "resolved"

  - `service_statuses` (array, required)
    Describes affected services and their statuses.

  - `service_statuses.service_id` (integer)
    Example: 1234

  - `service_statuses.status` (string)
    Enum: "up", "degraded-performance", "down"

  - `body` (string)
    Example: "Message for an event or event update.<br>\nMay contain basic HTML tags.\n"

  - `silent` (boolean)
    When true notifications are not being sent to subscribers. Does not impact draft notifications for Team Members.

  - `state` (string,null)
    State of Incident or Incident Update:

* draft - Not published on Hub Page,
* unconfirmed - Published on Hub Page but marked as unconfirmed,
* published - Published on Hub Page.
    Enum: "draft", "unconfirmed", "published"

  - `original_incident_id` (integer)
    Used when creating a follow-up incident. Indicated the incident to which current incident is a follow-up. Original Incident ID has to be resolved.
    Example: 102

## Response 200 fields (application/json):

  - `id` (integer)
    Example: 15

  - `author` (string,null)
    Author email

  - `title` (string)
    Title of incident as visible on Hub Page. If there is draft IncidentUpdate that changes the title, the title will not reflect this change because the draft update is not published and therefore not visible on Hub Page.

  - `created_at` (string)
    Timestamp of record creation. ISO8601 formatted time (UTC).
    Example: "2020-09-01T08:29:00Z"

  - `start_time` (string)
    Timestamp of the start_time of the first (by start_time) Incident Update. ISO8601 formatted time (UTC).
    Example: "2020-09-01T08:29:00Z"

  - `updated_at` (string)
    Timestamp of last modification of record. ISO8601 formatted time (UTC).
    Example: "2020-09-01T08:29:00Z"

  - `end_time` (string,null)
    Timestamp of event end. If not set it means that the event has not ended yet. ISO8601 formatted time (UTC).
    Example: "2020-09-01T08:29:00Z"

  - `flags` (any)