Documentation version: Latest (v1)
Technical Guide
Webhooks
Webhooks push delivery events (delivered, opened, clicked, bounced) to an endpoint on your server, allowing you to react to user engagement instantly.
Signature validation
To ensure authenticity, Risu Mail signs every webhook request. You should calculate the HMAC signature using your webhook secret and compare it to the 'X-Risu-Signature' header.
Idempotency
Always log the 'event_id' and ensure your handler is idempotent. We may occasionally send duplicate events if your server doesn't respond with a 200 OK within 10 seconds.
Ready to integrate?
Start building with our free tier and follow our detailed API contract.