HookTestHookTest
← All Guides

Test Linear Webhooks with HookTest

Test Linear webhooks for issue, project, and cycle tracking events. Use HookTest to create a free webhook URL, point Linear at it, and inspect every request in real time — headers, body, and signature included.

Quick Start

Get Linear webhooks flowing to HookTest in under a minute:

  1. Create a HookTest URL. Go to hooktest.dev and click Create Bin. Copy the webhook URL.
  2. Add it to Linear webhook settings. Paste the HookTest URL as your webhook endpoint in the Linear developer dashboard. Select the events you want to receive.
  3. Trigger an event and inspect. Perform an action in Linear (or use their test/sandbox mode) and watch the request appear in HookTest in real time. Check headers, body, and query parameters.

Common Linear Webhook Events

These are the most commonly tested Linear webhook events. Each one triggers an HTTP POST to your webhook URL with a JSON payload.

EventDescription
Issue.createA new issue is created
Issue.updateAn issue is modified
Comment.createA comment is added
Cycle.updateA cycle is modified

Verifying Linear Signatures

Linear signs every webhook request using the Linear-Signature header. You should always verify this signature in production to confirm the request actually came from Linear and was not tampered with in transit.

When testing with HookTest, you can inspect the raw signature header value in the request details. This is useful for verifying that your signature verification code handles the header format correctly before deploying to production.

See the official Linear webhook docs for the full signature verification algorithm and code samples.

Why Test Linear Webhooks?

Webhook handlers are notoriously hard to debug. You cannot see what Linear is sending until your endpoint receives it, and errors in your handler can cause silent failures — missed payments, lost data, or broken integrations.

HookTest gives you full visibility into every request before you write a line of handler code. Create a bin, point Linear at it, and see exactly what arrives: HTTP method, headers (including signatures), body, and query parameters. Once your handler is ready, use webhook forwarding to send requests to your local server in real time.

Start testing Linear webhooks

Create a free webhook URL in one click. No signup required.

Create Free Webhook URL

Related Guides