Create issue

createIssue creates an issue in a required team and lets Linear choose the team’s default workflow state when stateId is omitted.

automations/create-linear-issue.automation.ts

import { automation, onHttpRequest } from "automate.ax"
import { createIssue } from "automate.ax/linear"

export default automation("Create Linear issue", () => {
  onHttpRequest({ scope: "automation" })
  createIssue({
    teamId: "team-uuid",
    title: "Investigate customer report",
    description: "Review the attached evidence.",
    priority: 2,
    labelIds: ["label-uuid"],
  })
})

teamId and non-empty title are required. Optional fields are assigneeId, cycleId, Markdown description, dueDate (YYYY-MM-DD), nonnegative integer estimate, labelIds, parentId, priority (integer 0–4, where 0 is none and 4 is low), projectId, stateId, subscriberIds, and account. Returns the created LinearIssue. Referenced users, labels, cycle, state, parent, and project must be compatible with the selected team.

⌘I

Get started

Concepts

Reference