POST requests to your webhook URL when key events occur. Always verify the signature before processing.
Events
Payload structure
Signature verification
Every request includes anX-Mippo-Signature header — an HMAC-SHA256 of the raw request body using your webhook secret.
webhook-handler.ts
Use
express.raw() (not express.json()) so the raw body is preserved for signature verification. JSON parsing after verification is fine.Retry policy
If your endpoint returns a non-2xx status or times out (5s), Mippo retries with exponential backoff:
After 5 failed retries, the event is marked as
FAILED and you are notified by email.