Skip to content

Linear Issue Create

Overview

The Linear Issue Create node calls the Linear API to create a new issue in a specified team and project, then emits the created issue object downstream. It requires a Linear API credential configured in the workflow's secrets, and the team must exist before execution. If creation fails (e.g. invalid team ID, auth error, or API rate limit), the node routes execution to the error output port instead of halting the workflow.

Configuration

FieldTypeRequiredDescription
credentialIdstringYesID of the stored Linear API key credential used to authenticate requests.
teamIdstringYesLinear team ID where the issue will be created. Found in team settings.
projectIdstringNoOptional Linear project ID to associate the issue with a specific project inside the team.
titlestringYesTitle of the issue. Supports template expressions (e.g. {{input.battleTitle}}).
descriptionstringNoMarkdown body for the issue. Supports template expressions.
priorityenumNoIssue priority: no_priority, urgent, high, medium, or low. Defaults to no_priority.
assigneeIdstringNoLinear user ID to assign the issue to on creation.
labelIdsstringNoComma-separated list of Linear label IDs to attach to the issue.

Inputs

PortTypeDescription
inputobjectTrigger signal and payload from the previous node. Values are available as template variables in title, description, and other config fields.

Outputs

PortTypeDescription
outputobjectThe created Linear issue object, including id, identifier, title, url, and state fields.
errorobjectEmitted when issue creation fails. Contains message, statusCode, and the original input payload.

Example

json
{
  "nodeType": "linear_issue_create",
  "config": {
    "credentialId": "cred_linear_prod",
    "teamId": "TEAM-abc123",
    "title": "Battle failed: {{input.battleTitle}}",
    "description": "Execution `{{input.executionId}}` ended with status `{{input.status}}`.\n\nSee battle: {{input.battleUrl}}",
    "priority": "high"
  }
}