Skip to main content
Mippo sends signed POST requests to your webhook URL when key events occur. Always verify the signature before processing.

Events

Payload structure

Signature verification

Every request includes an X-Mippo-Signature header — an HMAC-SHA256 of the raw request body using your webhook secret.
Always verify the signature. Never process webhook events from unverified sources.
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.

Rotating your webhook secret

In the Partner Dashboard, click Rotate secret. Your old secret remains valid for 30 minutes during the transition window.