On initiative created - Automate.ax

linear.onInitiativeCreated handles initiative created in the connected Linear workspace.

automations/watch-linear-initiative.automation.ts

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

export default automation("On initiative created", () => {
  const event = linear.onInitiativeCreated()
  // Sync the Linear initiative to the portfolio roadmap.
})

Optional static account defaults to the project binding. Linear webhook triggers require an OAuth connection with read access. The workspace can’t change at runtime.

Trigger data

Returns a Signal<LinearInitiativeTrigger>:

type LinearInitiativeTrigger = LinearInitiative & {
  event: LinearWebhookEvent<LinearInitiative, "create">
}

interface LinearInitiative {
  archivedAt?: string | null
  canceledAt?: string | null
  completedAt?: string | null
  createdAt: string
  description: string
  health?: string | null
  id: string
  identifier?: string | null
  labelIds: string[]
  name: string
  organizationId: string
  ownerId?: string | null
  targetDate?: string | null
  updatedAt: string
  url: string
}

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

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

Initiative events expose workspace ownership, labels, health, and target-date state directly from Linear. Resource objects and the webhook envelope retain extra Linear fields.