Skip to main content
CompliAPI POSTs monitoring webhook events as JSON to your configured endpoints. This page documents the wire format; configuration happens on the dashboard’s Webhooks page.

Request

Answer any 2xx within 10 seconds to acknowledge. Other responses (and timeouts) are retried — see delivery and retries.

Payload

Verifying the signature

The X-CompliAPI-Signature header is t=<unix timestamp>,v1=<hex HMAC-SHA256>, where the MAC is computed over "{t}." + <raw request body> with your endpoint’s signing secret (whsec_..., from the dashboard). Verify with a constant-time comparison and reject stale timestamps (we recommend a 5-minute tolerance) to prevent replays.
Verify against the raw request body bytes. Parsing the JSON and re-serializing it will produce different bytes and a false mismatch. Rotating the secret from the dashboard invalidates the previous secret immediately — update your consumer first, then rotate.