Skip to main content
POST
Linear issue-state webhook (feedback resolution)

Headers

linear-signature
string
required

HMAC-SHA-256 hex digest of the raw request body, keyed on LINEAR_WEBHOOK_SIGNING_SECRET, timing-safe-compared.

Body

application/json

Linear's Issue webhook payload. Only type: "Issue" with action: "update"|"create" is processed; other events are acknowledged as no-ops.

type
string

Linear event type, e.g. "Issue".

action
string

e.g. "update", "create".

data
object

The Issue resource: id (Linear UUID), identifier (e.g. "MNE-1234"), state.name/state.type, description, mergeCommitHash, releaseLabel.

Response

Acknowledged — either a real resolution was recorded (resolved: true/false reflecting whether this was already resolved) or the event was a no-op (skipped: <reason>).

ok
boolean
required
skipped
string

Set when no action was taken: "not_an_issue_event" | "not_a_resolution_state" | "no_linked_work_item".

resolved
boolean
submission_id
string<uuid>