Receive Linear webhook
POST
/webhooks/linear/{webhookId}Signed request
Proven by Linear-Signature, delivery, stamp, and workspace, not by a session.
POST /webhooks/linear/{webhookId} needs no session or CSRF token. A delivery proves itself with four things, all of which must hold:
Path parameters
| Name | Type | Required | Notes |
|---|---|---|---|
webhookId | string | Required |
Headers
| Name | Type | Required | Notes |
|---|---|---|---|
Linear-Signature | string | Optional | |
Linear-Delivery | string | Optional |
Request body
application/json · The body is optional.
The provider’s JSON payload, exactly as it was signed.
Response
Success: 200
| Field | Type | Required | Notes |
|---|---|---|---|
outcome | string | Optional |
Errors
| Status | Code | Applies to |
|---|---|---|
400 | invalid_parametera path or query parameter is missing or does not convert, such as an ID that is not a UUID | Any endpoint |
404 | not_foundno such address | Any endpoint |
405 | method_not_allowedthe address does not take that method | Any endpoint |
415 | unsupported_media_typethe address does not read a body of that type | Any endpoint |
500 | internal_errora fault ReleaseFlow did not foresee; the body never carries the exception behind it | Any endpoint |
400 | webhook_payload_malformed | Webhooks area |
401 | webhook_signature_invalid | Webhooks area |
413 | webhook_payload_too_large | Webhooks area |
422 | webhook_repository_mismatch | Webhooks area |
Request
bash
# Sign the exact bytes of payload.json with the webhook secret (see the guide).
curl -X POST "http://localhost:8080/webhooks/linear/$WEBHOOK_ID" \
-H "Linear-Signature: $LINEAR_SIGNATURE" \
-H "Linear-Delivery: $LINEAR_DELIVERY" \
-H "Content-Type: application/json" \
--data-binary @payload.json
Response
200Example
{
"outcome": "<string>"
}