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
OAuthApp 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.
AgentSessionEvent
documented No payload yet
AgentSessionEvent 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.
AppUserNotification
documented No payload yet
AppUserNotification 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.
PermissionChange
documented No payload yet
PermissionChange 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.
issue
Issue
documented No payload yet
Issue Issue created, updated or removed
Identified by Linear-Event header and action field in the body
Resource issue
No payload yet.
Comment
documented from Linear docs (example)
Comment Comment on an issue created, updated or removed
Identified by Linear-Event header and action field in the body
Resource issue
{
"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
IssueLabel
documented No payload yet
IssueLabel Issue label created, updated or removed
Identified by Linear-Event header and action field in the body
Resource issue
No payload yet.
Attachment
documented No payload yet
Attachment Issue attachment created, updated or removed
Identified by Linear-Event header and action field in the body
Resource issue
No payload yet.
Reaction
documented No payload yet
Reaction Emoji reaction added or removed
Identified by Linear-Event header and action field in the body
Resource issue
No payload yet.
IssueSLA
documented No payload yet
IssueSLA 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.
project
Project
documented No payload yet
Project Project created, updated or removed
Identified by Linear-Event header and action field in the body
Resource project
No payload yet.
ProjectUpdate
documented No payload yet
ProjectUpdate 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.
ProjectLabel
documented No payload yet
ProjectLabel A project label changes
Identified by Linear-Event header and action field in the body
Resource project
No payload yet.
Cycle
documented No payload yet
Cycle Team cycle created, updated or removed
Identified by Linear-Event header and action field in the body
Resource project
No payload yet.
Document
documented No payload yet
Document Document created, updated or removed
Identified by Linear-Event header and action field in the body
Resource project
No payload yet.
Initiative
documented No payload yet
Initiative Initiative created, updated or removed
Identified by Linear-Event header and action field in the body
Resource project
No payload yet.
InitiativeUpdate
documented No payload yet
InitiativeUpdate 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.
Other Linear events
AuditEntry
documented from Linear docs (example)
AuditEntry New entry written to the workspace audit log
Identified by Linear-Event header and action field in the body
{
"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
Customer
documented No payload yet
Customer Customer record created, updated or removed
Identified by Linear-Event header and action field in the body
No payload yet.
CustomerNeed
documented No payload yet
CustomerNeed Customer request created, updated or removed
Identified by Linear-Event header and action field in the body
No payload yet.
Release
documented No payload yet
Release A release changes
Identified by Linear-Event header and action field in the body
No payload yet.
ReleaseNote
documented No payload yet
ReleaseNote A release note changes
Identified by Linear-Event header and action field in the body
No payload yet.
User
documented No payload yet
User Workspace user created, updated or removed
Identified by Linear-Event header and action field in the body
No payload yet.
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.