Linear: Create Issue

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

Inputs

NameDescription
IntegrationSelect your Linear connection. If you have not yet configured a Linear integration, please see the Linear Integration instructions.
TeamThe Linear team where the issue will be created. Selecting a team populates the State and Assignee dropdowns.
TitleTitle 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

NameDescription
Issue IDThe unique UUID identifier of the created Linear issue. Use this in subsequent actions that require an issue ID.
Issue URLDirect URL to view the issue in Linear. Useful for including in notifications or follow-up communications.
Issue IdentifierThe human-readable identifier for the issue in the format [TEAM]-[NUMBER] (e.g., ENG-123).
ResultStatus of the action execution. Returns Success or Failed.
Result SummaryBrief description of the action result, such as Issue created successfully: ENG-123 or error details if the action failed.
ErrorError 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.