Linear Integration

Set up HookWatch to receive Linear webhooks for project management events like issue updates, new comments, project changes, and cycle progress.

Prerequisites

A HookWatch account
A Linear workspace with admin access
A server endpoint to process webhook payloads

Step 1: Create a HookWatch endpoint

Go to your Endpoints page
Click "Create Endpoint"
Enter a name like "Linear Webhooks"
Enter your destination URL (where you want webhooks forwarded)
Copy the generated webhook URL

Your HookWatch URL will look like:

https://hook.hookwatch.dev/wh/abc123xyz

Step 2: Configure Linear webhooks

Go to Linear Settings
Navigate to "API" in the sidebar
Scroll down to the "Webhooks" section
Click "Create new webhook"
Paste your HookWatch URL in the "URL" field
Add a label like "HookWatch"
Select the resource types you want to subscribe to
Click "Create webhook"
Copy the signing secret displayed — you'll need it for verification

Available resource types:

Issue (create, update, remove)

Comment (create, update, remove)

Project (create, update)

Cycle (create, update)

Label (create, update)

Issue attachment

Step 3: Verify webhooks on your server

Linear signs webhook payloads using HMAC-SHA256. HookWatch forwards the Linear-Signature header so you can verify authenticity.

Node.js / Express

Linear webhook payload structure

Linear sends a consistent JSON payload structure for all webhook events:

Field	Description
`action`	The action performed (create, update, remove)
`type`	The resource type (Issue, Comment, Project, etc.)
`data`	The full resource object
`updatedFrom`	Previous values for changed fields (update actions only)
`url`	Direct URL to the resource in Linear

Testing the integration

Create a new issue in Linear
Update an issue's status or assignee
Add a comment to an issue
Check your HookWatch Events page to see the events

Common issues

Signature verification fails

Make sure you're using the raw request body for signature verification, not the parsed JSON. The signature is computed on the exact bytes Linear sends.

Not receiving certain events

Verify that you've subscribed to the correct resource types when creating the webhook. Linear webhooks are scoped to specific resource types, not individual event types.

Webhook automatically disabled

Linear disables webhooks after consecutive failures. With HookWatch's reliable endpoint, this is rare. Check the webhook status in Linear settings if events stop arriving.