# Create an Incident

Opens a brand-new incident directly on a specified PagerDuty service as an automated first step inside an incident workflow.


> **Availability:** See the [Incident Workflow Actions Overview table](/workflow-actions) for the plans this workflow is available on.

## Description

Create a new incident on a specified service.

## Instructions

1. If you have not done so, follow the instructions to [Create an Incident Workflow](/ai-automation/automation/incident-workflows#create-an-incident-workflow).
2. When the instructions prompt you to [add actions](/ai-automation/automation/incident-workflows#add-actions), select **this action**.
3. Enter the following **Inputs** and click **Save**.
4. Continue following instructions to **Publish** the Workflow.
5. When the action runs, you will see the **Outputs** listed below.

## Inputs

> **Field References:** Fields with the **\{+\}** icon accept [Field References](/ai-automation/automation/incident-workflows#field-references), which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click **\{+\}**, or enter `{{`, and select relevant fields. Refer to the [Field References](/ai-automation/automation/incident-workflows#field-references) article for more information.

| Name              | Description                                                                                      |
| :---------------- | :----------------------------------------------------------------------------------------------- |
| Title             | **Required**: The title of the incident                                                          |
| Incident Type     | **Required**: The type of incident to create                                                     |
| Impacted Service  | **Required**: The ID or name of the service impacted by the incident                             |
| Description       | A detailed description of the incident                                                           |
| Urgency           | **Required**: The urgency level of the incident (e.g., **high**, **low**). Defaults to **high**. |
| Priority          | The priority of the incident                                                                     |
| Conference URL    | The URL of the conference bridge associated with the incident                                    |
| Conference Number | The phone number for the conference bridge associated with the incident                          |

## Outputs

| Name            | Description                                                                         |
| :-------------- | :---------------------------------------------------------------------------------- |
| Incident ID     | The newly-created incident's ID                                                     |
| Incident Number | The newly-created incident's assigned unique number                                 |
| Incident URL    | The newly-created incident's URL                                                    |
| Result          | Value that shows if the action was successful or not. Either "Success" or "Failed." |
| Result Summary  | Brief description of what the action did or if it failed.                           |
| Error           | Brief description that populates if the action failed.                              |

<br />

## PagerDuty API Endpoint

Endpoint used:

- <a target="_blank" href="/developer/api/reference/rest/incidents/create-incident">Create an Incident</a>

<br />