Linear webhook events

23 Linear event types in 3 resources, plus Other Linear events. 2 have sample payloads.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

app

OAuthApp

documented No payload yet

Your OAuth app is de-authorized from a workspace

Identified by Linear-Event header and action field in the body Resource app

No payload yet.

Help fill this in → View as JSON

AgentSessionEvent

documented No payload yet

Your agent is mentioned, delegated an issue or sent a prompt

Identified by Linear-Event header and action field in the body Resource app

No payload yet.

Help fill this in → View as JSON

AppUserNotification

documented No payload yet

Inbox notification for your app's user, such as a mention

Identified by Linear-Event header and action field in the body Resource app

No payload yet.

Help fill this in → View as JSON

PermissionChange

documented No payload yet

Your app gains or loses access to a team

Identified by Linear-Event header and action field in the body Resource app

No payload yet.

Help fill this in → View as JSON

issue

Issue

documented No payload yet

Issue created, updated or removed

Identified by Linear-Event header and action field in the body Resource issue

No payload yet.

Help fill this in → View as JSON

Comment

documented from Linear docs (example)

Comment on an issue created, updated or removed

Identified by Linear-Event header and action field in the body Resource issue

linear-comment.json
{
  "action": "create",
  "actor": { … },
  "data": { … },
  "type": "Comment",
  "url": "https://linear.app/issue/LIN-1778/foo-bar#comment-77217de3-fb52-4dad-bb9a-b356beb93de8",
  "createdAt": "2020-01-23T12:53:18.084Z",
  "organizationId": "dc844923-f9a4-40a3-825c-dea7747e57d6",
  "webhookTimestamp": 1676056940508,
  "webhookId": "000042e3-d123-4980-b49f-8e140eef9329"
}

Key fields

Field Type Example
type string Comment

Full schema: 22 fields.

From Linear docs

  • Content type application/json

Send example to Inspect → View as JSON

IssueLabel

documented No payload yet

Issue label created, updated or removed

Identified by Linear-Event header and action field in the body Resource issue

No payload yet.

Help fill this in → View as JSON

Attachment

documented No payload yet

Issue attachment created, updated or removed

Identified by Linear-Event header and action field in the body Resource issue

No payload yet.

Help fill this in → View as JSON

Reaction

documented No payload yet

Emoji reaction added or removed

Identified by Linear-Event header and action field in the body Resource issue

No payload yet.

Help fill this in → View as JSON

IssueSLA

documented No payload yet

An issue's SLA is set, at high risk or breached

Identified by Linear-Event header and action field in the body Resource issue

No payload yet.

Help fill this in → View as JSON

project

Project

documented No payload yet

Project created, updated or removed

Identified by Linear-Event header and action field in the body Resource project

No payload yet.

Help fill this in → View as JSON

ProjectUpdate

documented No payload yet

Status update on a project created, updated or removed

Identified by Linear-Event header and action field in the body Resource project

No payload yet.

Help fill this in → View as JSON

ProjectLabel

documented No payload yet

A project label changes

Identified by Linear-Event header and action field in the body Resource project

No payload yet.

Help fill this in → View as JSON

Cycle

documented No payload yet

Team cycle created, updated or removed

Identified by Linear-Event header and action field in the body Resource project

No payload yet.

Help fill this in → View as JSON

Document

documented No payload yet

Document created, updated or removed

Identified by Linear-Event header and action field in the body Resource project

No payload yet.

Help fill this in → View as JSON

Initiative

documented No payload yet

Initiative created, updated or removed

Identified by Linear-Event header and action field in the body Resource project

No payload yet.

Help fill this in → View as JSON

InitiativeUpdate

documented No payload yet

Status update on an initiative created, updated or removed

Identified by Linear-Event header and action field in the body Resource project

No payload yet.

Help fill this in → View as JSON

Other Linear events

AuditEntry

documented from Linear docs (example)

New entry written to the workspace audit log

Identified by Linear-Event header and action field in the body

linear-auditentry.json
{
  "action": "create",
  "actor": { … },
  "createdAt": "2025-03-28T19:46:18.441Z",
  "data": { … },
  "type": "AuditEntry",
  "organizationId": "5a3b982d-8f04-4971-956c-fbcb2c68642a",
  "webhookTimestamp": 1743191178476,
  "webhookId": "f1d0caa0-a974-4604-a300-a4edbba66803"
}

Key fields

Field Type Example
type string AuditEntry

Full schema: 31 fields.

From Linear docs

  • Content type application/json

Send example to Inspect → View as JSON

Customer

documented No payload yet

Customer record created, updated or removed

Identified by Linear-Event header and action field in the body

No payload yet.

Help fill this in → View as JSON

CustomerNeed

documented No payload yet

Customer request created, updated or removed

Identified by Linear-Event header and action field in the body

No payload yet.

Help fill this in → View as JSON

Release

documented No payload yet

A release changes

Identified by Linear-Event header and action field in the body

No payload yet.

Help fill this in → View as JSON

ReleaseNote

documented No payload yet

A release note changes

Identified by Linear-Event header and action field in the body

No payload yet.

Help fill this in → View as JSON

User

documented No payload yet

Workspace user created, updated or removed

Identified by Linear-Event header and action field in the body

No payload yet.

Help fill this in → View as JSON

Route Linear events by type.

Event Gateway receives every Linear delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Linear. Facts are compiled from public sources and linked inline.