# Linear: Create Issue

Creates a new Linear issue with a custom title, description, team assignment, priority level, and workflow state from an incident.


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

## Description

Create a new issue in Linear with customizable title, description, team assignment, priority level, and workflow state. This action enables automated issue creation during incident response, allowing teams to track follow-up work, post-incident tasks, and remediation items directly from PagerDuty incidents.

## 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 |
| :--- | :--- |
| **Integration** | Select your Linear connection. If you have not yet configured a Linear integration, please see the [Linear Integration](/ai-automation/automation/incident-workflows/workflow-integrations#linear) instructions. |
| **Team** | The Linear team where the issue will be created. Selecting a team populates the State and Assignee dropdowns. |
| **Title** | Title for the issue (max 255 characters). Default value is `{{incident.title}}`. |
| **Description** _(optional)_ | Description for the issue in Markdown format (max 10,000 characters). Default value is `{{incident.url}}`. Supports full Markdown syntax including headers, lists, and links. |
| **Priority** _(optional)_ | Issue priority level. Options: `0` (No priority), `1` (Urgent), `2` (High), `3` (Medium), `4` (Low). Default is `0`. |
| **State** _(optional)_ | Workflow state for the issue (e.g., "Backlog", "Todo", "In Progress"). Available states depend on the selected team. If not specified, defaults to the team's backlog state. |
| **Assignee** _(optional)_ | Team member to assign the issue to. Available assignees depend on the selected team. If not specified, issue is created unassigned. |
| **Label** _(optional)_ | Label to apply to the issue. Select from workspace-wide labels. |

## Outputs

| Name                 | Description                                                                                                                  |
| :------------------- | :--------------------------------------------------------------------------------------------------------------------------- |
| **Issue ID**         | The unique UUID identifier of the created Linear issue. Use this in subsequent actions that require an issue ID.             |
| **Issue URL**        | Direct URL to view the issue in Linear. Useful for including in notifications or follow-up communications.                   |
| **Issue Identifier** | The human-readable identifier for the issue in the format `[TEAM]-[NUMBER]` \(e.g., `ENG-123`).                              |
| **Result**           | Status of the action execution. Returns `Success` or `Failed`.                                                               |
| **Result Summary**   | Brief description of the action result, such as `Issue created successfully: ENG-123` or error details if the action failed. |
| **Error**            | Error message if the action failed. Empty if successful.                                                                     |

## Examples

**Basic Issue Creation**

Create a Linear issue with incident details:

- **Team:** Engineering
- **Title: **`{{incident.title}}`
- **Description: **`{{incident.url}}`

This creates a basic issue with the incident title and URL in the description.