Linear Create

Linear Create

Certified

Create an issue in Linear

Creates a Linear issue via GraphQL. Resolves the team by name (case-insensitive) and optionally attaches labels by their names. Returns Linear's mutation success flag and the created issue id.

yaml
type: io.kestra.plugin.linear.issues.Create
yaml
id: linear_issues_create
namespace: company.team

tasks:
  - id: create_issue
    type: io.kestra.plugin.linear.issues.Create
    token: "{{ secret('LINEAR_API_TOKEN') }}"
    team: MyTeamName
    title: "Increased 5xx in Demo Service"
    description: "The number of 5xx has increased beyond the threshold for Demo service."
    labels:
      - Bug
      - Workflow

Create an issue when a Kestra workflow in any namespace with company as prefix fails.

yaml
id: create_ticket_on_failure
namespace: system

tasks:
  - id: create_issue
    type: io.kestra.plugin.linear.issues.Create
    token: "{{ secret('LINEAR_API_TOKEN') }}"
    team: MyTeamName
    title: Workflow failed
    description: "{{ execution.id }} has failed on {{ taskrun.startDate }}. See the link below for more details."
    labels:
      - Bug
      - Workflow

triggers:
  - id: on_failure
    type: io.kestra.plugin.core.trigger.Flow
    conditions:
      - type: io.kestra.plugin.core.condition.ExecutionStatus
        in:
          - FAILED
          - WARNING
      - type: io.kestra.plugin.core.condition.ExecutionNamespace
        namespace: company
        comparison: PREFIX
Properties

Issue description

Optional issue body; rendered with flow variables before sending to Linear.

SubTypestring

Label names

Labels to attach, matched by name. If empty, the issue is created without labels.

Reference (ref) of the pluginDefaults to apply to this task.

Team name

Linear team name used to look up the team id; comparison is case-insensitive.

Issue title

Title text for the issue; templating supported through property rendering.

Linear API token

Full Authorization header value for Linear (usually the personal API key). Treat as secret and supply any needed prefix such as Bearer yourself.

Shows whether request was successful

True when the API call returns HTTP 200 and Linear reports success for the mutation.

Issue id

Identifier of the created issue when the mutation succeeds.