{
  "generated_from": "hookdeck/webhook-registry",
  "registry_commit": "a24c8d9784c9e9fe937c63f76adbce108201378f",
  "registry_committed_at": "2026-11-19T08:56:09Z",
  "disclaimer": "Independent reference. Not affiliated with Linear.",
  "vendor": "linear",
  "name": "Linear",
  "official_docs": "https://linear.app/developers/webhooks",
  "docs_checked": "2026-10-28",
  "url": "https://hookdeck.com/webhooks/linear",
  "pages": [
    {
      "tab": "overview",
      "label": "Overview",
      "url": "https://hookdeck.com/webhooks/linear"
    },
    {
      "tab": "events",
      "label": "Webhook events",
      "url": "https://hookdeck.com/webhooks/linear/events"
    },
    {
      "tab": "mcp-events",
      "label": "MCP events",
      "url": "https://hookdeck.com/webhooks/linear/mcp-events"
    },
    {
      "tab": "verify",
      "label": "Verify signatures",
      "url": "https://hookdeck.com/webhooks/linear/verify"
    },
    {
      "tab": "guide",
      "label": "Production guide",
      "url": "https://hookdeck.com/webhooks/linear/guide-duplicates-ordering-retries-timeouts"
    },
    {
      "tab": "skill",
      "label": "Agent skill",
      "url": "https://hookdeck.com/webhooks/linear/skill"
    }
  ],
  "summary": "Linear signs every webhook with Linear-Signature (HMAC-SHA256).",
  "facts": [
    {
      "key": "signature_header",
      "label": "Signature header",
      "value": "Linear-Signature",
      "detail": "Format: <hex>",
      "source": {
        "kind": "vendor-docs",
        "label": "Linear docs",
        "href": "https://linear.app/developers/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "scheme",
      "label": "Scheme",
      "value": "HMAC-SHA256",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Linear docs",
        "href": "https://linear.app/developers/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "signed_material",
      "label": "Signed material",
      "value": "{raw body}",
      "detail": "The request body as sent, with nothing added. webhookTimestamp is a field in that body, so the signature covers it.",
      "source": {
        "kind": "vendor-docs",
        "label": "Linear docs",
        "href": "https://linear.app/developers/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "identified_by",
      "label": "How events are identified",
      "value": "Linear-Event header and action field in the body",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Linear docs",
        "href": "https://linear.app/developers/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "body_format",
      "label": "Body format",
      "value": "JSON",
      "detail": "Content type: application/json.",
      "source": {
        "kind": "vendor-docs",
        "label": "Linear docs",
        "href": "https://linear.app/developers/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "timestamp",
      "label": "Replay window",
      "value": "1 minutes",
      "detail": "Linear recommends this check rather than enforcing it, so your handler makes it. Compare the body's `webhookTimestamp`, in Unix milliseconds, with your clock.",
      "source": {
        "kind": "vendor-docs",
        "label": "Linear docs",
        "href": "https://linear.app/developers/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "other_headers",
      "label": "Other headers",
      "value": "linear-delivery, linear-event, linear-timestamp",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Linear docs",
        "href": "https://linear.app/developers/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "envelope",
      "label": "Envelope",
      "value": "action, type, actor, createdAt, data, url, updatedFrom, webhookTimestamp, webhookId, organizationId",
      "detail": null,
      "source": {
        "kind": "vendor-docs",
        "label": "Linear docs",
        "href": "https://linear.app/developers/webhooks"
      },
      "doc_discrepancy": null
    },
    {
      "key": "agent_skill",
      "label": "Agent skill",
      "value": "npx skills add hookdeck/webhook-skills --skill linear-webhooks",
      "detail": null,
      "source": {
        "kind": "webhook-skills",
        "label": "Agent skill →",
        "href": "https://hookdeck.com/webhooks/linear/skill"
      },
      "doc_discrepancy": null
    }
  ],
  "not_yet_known": [],
  "enumeration": {
    "status": "partial",
    "source_url": "https://linear.app/developers/webhooks",
    "checked": "2026-07-28"
  },
  "counts": {
    "events": 23,
    "with_payload": 2,
    "captured": 0,
    "with_description": 23,
    "resources": 4,
    "confidence": {
      "verified": 0,
      "documented": 23,
      "inferred": 0
    }
  },
  "mcp": {
    "native": "unknown",
    "checked": null,
    "via_hookdeck": "any Linear event"
  },
  "events": [
    {
      "name": "Issue",
      "resource": "issue",
      "description": "Issue created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Issue",
      "json": "https://hookdeck.com/webhooks/linear/events/issue.json"
    },
    {
      "name": "Comment",
      "resource": "issue",
      "description": "Comment on an issue created, updated or removed",
      "confidence": "documented",
      "schema_source": "from Linear docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linear/events#Comment",
      "json": "https://hookdeck.com/webhooks/linear/events/comment.json"
    },
    {
      "name": "IssueLabel",
      "resource": "issue",
      "description": "Issue label created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#IssueLabel",
      "json": "https://hookdeck.com/webhooks/linear/events/issuelabel.json"
    },
    {
      "name": "Attachment",
      "resource": "issue",
      "description": "Issue attachment created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Attachment",
      "json": "https://hookdeck.com/webhooks/linear/events/attachment.json"
    },
    {
      "name": "Reaction",
      "resource": "issue",
      "description": "Emoji reaction added or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Reaction",
      "json": "https://hookdeck.com/webhooks/linear/events/reaction.json"
    },
    {
      "name": "IssueSLA",
      "resource": "issue",
      "description": "An issue's SLA is set, at high risk or breached",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#IssueSLA",
      "json": "https://hookdeck.com/webhooks/linear/events/issuesla.json"
    },
    {
      "name": "Project",
      "resource": "project",
      "description": "Project created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Project",
      "json": "https://hookdeck.com/webhooks/linear/events/project.json"
    },
    {
      "name": "ProjectUpdate",
      "resource": "project",
      "description": "Status update on a project created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#ProjectUpdate",
      "json": "https://hookdeck.com/webhooks/linear/events/projectupdate.json"
    },
    {
      "name": "ProjectLabel",
      "resource": "project",
      "description": "A project label changes",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#ProjectLabel",
      "json": "https://hookdeck.com/webhooks/linear/events/projectlabel.json"
    },
    {
      "name": "Cycle",
      "resource": "project",
      "description": "Team cycle created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Cycle",
      "json": "https://hookdeck.com/webhooks/linear/events/cycle.json"
    },
    {
      "name": "Document",
      "resource": "project",
      "description": "Document created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Document",
      "json": "https://hookdeck.com/webhooks/linear/events/document.json"
    },
    {
      "name": "Initiative",
      "resource": "project",
      "description": "Initiative created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Initiative",
      "json": "https://hookdeck.com/webhooks/linear/events/initiative.json"
    },
    {
      "name": "InitiativeUpdate",
      "resource": "project",
      "description": "Status update on an initiative created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#InitiativeUpdate",
      "json": "https://hookdeck.com/webhooks/linear/events/initiativeupdate.json"
    },
    {
      "name": "Customer",
      "resource": "Customer",
      "description": "Customer record created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Customer",
      "json": "https://hookdeck.com/webhooks/linear/events/customer.json"
    },
    {
      "name": "CustomerNeed",
      "resource": "CustomerNeed",
      "description": "Customer request created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#CustomerNeed",
      "json": "https://hookdeck.com/webhooks/linear/events/customerneed.json"
    },
    {
      "name": "User",
      "resource": "User",
      "description": "Workspace user created, updated or removed",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#User",
      "json": "https://hookdeck.com/webhooks/linear/events/user.json"
    },
    {
      "name": "Release",
      "resource": "Release",
      "description": "A release changes",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#Release",
      "json": "https://hookdeck.com/webhooks/linear/events/release.json"
    },
    {
      "name": "ReleaseNote",
      "resource": "ReleaseNote",
      "description": "A release note changes",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#ReleaseNote",
      "json": "https://hookdeck.com/webhooks/linear/events/releasenote.json"
    },
    {
      "name": "AuditEntry",
      "resource": "AuditEntry",
      "description": "New entry written to the workspace audit log",
      "confidence": "documented",
      "schema_source": "from Linear docs (example)",
      "has_payload": true,
      "url": "https://hookdeck.com/webhooks/linear/events#AuditEntry",
      "json": "https://hookdeck.com/webhooks/linear/events/auditentry.json"
    },
    {
      "name": "OAuthApp",
      "resource": "app",
      "description": "Your OAuth app is de-authorized from a workspace",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#OAuthApp",
      "json": "https://hookdeck.com/webhooks/linear/events/oauthapp.json"
    },
    {
      "name": "AgentSessionEvent",
      "resource": "app",
      "description": "Your agent is mentioned, delegated an issue or sent a prompt",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#AgentSessionEvent",
      "json": "https://hookdeck.com/webhooks/linear/events/agentsessionevent.json"
    },
    {
      "name": "AppUserNotification",
      "resource": "app",
      "description": "Inbox notification for your app's user, such as a mention",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#AppUserNotification",
      "json": "https://hookdeck.com/webhooks/linear/events/appusernotification.json"
    },
    {
      "name": "PermissionChange",
      "resource": "app",
      "description": "Your app gains or loses access to a team",
      "confidence": "documented",
      "schema_source": "No payload yet",
      "has_payload": false,
      "url": "https://hookdeck.com/webhooks/linear/events#PermissionChange",
      "json": "https://hookdeck.com/webhooks/linear/events/permissionchange.json"
    }
  ]
}