# Linear webhook events

Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/linear/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill linear-webhooks` ([details](https://hookdeck.com/webhooks/linear/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Linear's official docs](https://linear.app/developers/webhooks).

[Overview](https://hookdeck.com/webhooks/linear) · [Webhook events (23)](https://hookdeck.com/webhooks/linear/events) · [MCP events](https://hookdeck.com/webhooks/linear/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/linear/verify) · [Production guide](https://hookdeck.com/webhooks/linear/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/linear/skill)

## app

### OAuthApp

Confidence: documented · Schema: No payload yet

Your OAuth app is de-authorized from a workspace

Identified by: Linear-Event header and action field in the body · Object: `app`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/oauthapp.json)

### AgentSessionEvent

Confidence: documented · Schema: 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 · Object: `app`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/agentsessionevent.json)

### AppUserNotification

Confidence: documented · Schema: 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 · Object: `app`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/appusernotification.json)

### PermissionChange

Confidence: documented · Schema: No payload yet

Your app gains or loses access to a team

Identified by: Linear-Event header and action field in the body · Object: `app`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/permissionchange.json)

## issue

### Issue

Confidence: documented · Schema: No payload yet

Issue created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `issue`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/issue.json)

### Comment

Confidence: documented · Schema: from Linear docs (example)

Comment on an issue created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `issue`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/linear/events/comment.json)

| Key field | Type | Example |
|---|---|---|
| `type` | string | `Comment` |

From Linear docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/linear/events/comment.json)

### IssueLabel

Confidence: documented · Schema: No payload yet

Issue label created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `issue`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/issuelabel.json)

### Attachment

Confidence: documented · Schema: No payload yet

Issue attachment created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `issue`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/attachment.json)

### Reaction

Confidence: documented · Schema: No payload yet

Emoji reaction added or removed

Identified by: Linear-Event header and action field in the body · Object: `issue`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/reaction.json)

### IssueSLA

Confidence: documented · Schema: 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 · Object: `issue`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/issuesla.json)

## project

### Project

Confidence: documented · Schema: No payload yet

Project created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/project.json)

### ProjectUpdate

Confidence: documented · Schema: No payload yet

Status update on a project created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/projectupdate.json)

### ProjectLabel

Confidence: documented · Schema: No payload yet

A project label changes

Identified by: Linear-Event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/projectlabel.json)

### Cycle

Confidence: documented · Schema: No payload yet

Team cycle created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/cycle.json)

### Document

Confidence: documented · Schema: No payload yet

Document created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/document.json)

### Initiative

Confidence: documented · Schema: No payload yet

Initiative created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/initiative.json)

### InitiativeUpdate

Confidence: documented · Schema: No payload yet

Status update on an initiative created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `project`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/initiativeupdate.json)

## Other Linear events

### AuditEntry

Confidence: documented · Schema: from Linear docs (example)

New entry written to the workspace audit log

Identified by: Linear-Event header and action field in the body · Object: `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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/linear/events/auditentry.json)

| Key field | Type | Example |
|---|---|---|
| `type` | string | `AuditEntry` |

From Linear docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/linear/events/auditentry.json)

### Customer

Confidence: documented · Schema: No payload yet

Customer record created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `Customer`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/customer.json)

### CustomerNeed

Confidence: documented · Schema: No payload yet

Customer request created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `CustomerNeed`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/customerneed.json)

### Release

Confidence: documented · Schema: No payload yet

A release changes

Identified by: Linear-Event header and action field in the body · Object: `Release`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/release.json)

### ReleaseNote

Confidence: documented · Schema: No payload yet

A release note changes

Identified by: Linear-Event header and action field in the body · Object: `ReleaseNote`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/releasenote.json)

### User

Confidence: documented · Schema: No payload yet

Workspace user created, updated or removed

Identified by: Linear-Event header and action field in the body · Object: `User`

No payload yet.

[View as JSON](https://hookdeck.com/webhooks/linear/events/user.json)

---

Not affiliated with Linear. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/linear.json) · [Report a correction](https://hookdeck.com/contact)
