On Linear issue event

linear.onIssueEvent handles issue creation, updates, and removal.

automations/watch-linear-issues.automation.ts

import { automation } from "automate.ax"
import { linear } from "automate.ax/linear"

export default automation("Watch Linear issues", () => {
  const event = linear.onIssueEvent()
  // Route the Linear issue event by action.
})

Optional static account defaults to the project binding. The workspace can’t change at runtime.

Trigger data

Returns a Signal<LinearIssueEvent>:

type LinearIssueEvent = LinearIssue & {
  event: LinearWebhookEvent<LinearIssue, "Issue">
}

interface LinearIssue {
  archivedAt?: string | null
  assignee?: LinearUser | null
  assigneeId?: string | null
  canceledAt?: string | null
  completedAt?: string | null
  createdAt: string
  creator?: LinearUser | null
  creatorId?: string | null
  description?: string | null
  dueDate?: string | null
  estimate?: number | null
  id: string
  identifier: string
  labelIds: string[]
  labels: LinearLabel[]
  number: number
  parentId?: string | null
  priority: number
  priorityLabel: string
  project?: LinearProjectReference | null
  projectId?: string | null
  startedAt?: string | null
  state: LinearWorkflowState
  stateId: string
  subscriberIds: string[]
  team?: LinearTeam | null
  teamId: string
  title: string
  trashed?: boolean | null
  updatedAt: string
  url: string
}

interface LinearWebhookEvent<TData, TType extends string> {
  action: "create" | "update" | "remove"
  actor?: LinearActor | null
  createdAt: string
  data: TData
  organizationId: string
  type: TType
  updatedFrom?: Record<string, JSONValue>
  url?: string
  webhookId: string
  webhookTimestamp: number
}

interface LinearUser {
  avatarUrl?: string | null
  email: string
  id: string
  name: string
  url: string
}

interface LinearLabel {
  color: string
  id: string
  name: string
  parentId?: string | null
}

interface LinearProjectReference {
  id: string
  name: string
  url: string
}

interface LinearWorkflowState {
  color: string
  id: string
  name: string
  type: string
}

interface LinearTeam {
  id: string
  key: string
  name: string
}

interface LinearActor {
  email?: string
  id?: string
  name?: string
  type?: string
  url?: string
}

Resource objects and the webhook envelope retain extra Linear fields. Includes the changed issue’s id, identifier, title, timestamps, priority, workflow state, team, project, assignee, and labels. event contains the provider payload. Inspect event.action for the change or event.updatedFrom for previous values. Call linear.getIssue for the normalized issue after the event.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

On Linear issue event

Trigger data

​Trigger data

Trigger data