How to Receive Linear Webhooks Reliably

Linear can notify your systems when issues, comments and projects change — via webhooks you configure in Settings → API. But Linear just POSTs the event to a URL; you still own signature verification, retries when your service blips, and turning Linear's payload into whatever your downstream expects. Here's how to handle all of it with Bluejay Relay, no backend required.

What You'll Build

Linear → Bluejay Relay (verify + transform + route) → your app, Slack, or a spreadsheet.

1. Create the Webhook Endpoint

In Bluejay Relay, create a webhook named Linear Events — pick Linear from the source list and its verification is pre-selected. You get a unique capture URL:

https://in.bluejayrelay.com/api/webhooks/{your-token}

Every event is logged in full the instant it arrives.

2. Add the Webhook in Linear

In Linear, go to Settings → API → Webhooks, create a webhook, paste your Bluejay capture URL, and choose the resources to subscribe to (Issues, Comments, Projects...). Linear shows a signing secret — copy it.

3. Verify the Signature

Linear signs each request with an HMAC-SHA256 of the raw body, hex-encoded, in the Linear-Signature header. Paste the signing secret into Bluejay Relay and enable verification. Relay recomputes the HMAC and does a timing-safe comparison, rejecting anything that doesn't match.

4. Transform and Route

Linear payloads carry the action, the resource type, and the changed data. With Relay's field mapping you can flatten the parts you care about — data.title, data.state.name, the action — into a clean object, and send it to your API, a Slack channel, or a spreadsheet. One event can fan out to several destinations, each with its own shape.

5. Retries and Replay

If a destination is down, Relay retries with backoff and dead-letters what keeps failing. Replay missed events individually or in bulk once you're back up — so a deploy on your side never loses a Linear event.

---

Connect Linear in a minute on Bluejay Relay — the free tier is 10,000 events/month, no card required.