Webhooks
Webhooks send an HTTP POST to your server when events happen in Kerabie Mail — new email received, email opened, message sent, and more.
Available on: Premium plan.
Setting up a webhook
- Go to Settings → Webhooks.
- Click + Add webhook.
- Enter:
- URL — your server endpoint (must be publicly accessible HTTPS)
- Events — select which events to subscribe to
- Click Save.
Kerabie Mail will immediately send a test ping to verify your endpoint is reachable.
Available events
| Event | Payload |
|---|---|
email.received |
From, subject, UID, mailbox |
email.sent |
To, subject, UID |
email.opened |
UID, timestamp (tracked emails only) |
email.deleted |
UID, mailbox |
Webhook payload format
{
"event": "email.received",
"timestamp": "2025-01-15T09:30:00Z",
"data": {
"uid": "1234",
"mailbox": "you@yourdomain.com",
"from": "sender@example.com",
"subject": "Hello!"
}
}
Verifying webhook authenticity
Every webhook request includes a X-Kerabie-Signature header — an HMAC-SHA256 signature of the payload using your webhook secret. Verify this in your handler to ensure the request came from Kerabie Mail.
Retry policy
If your endpoint returns a non-2xx response, Kerabie Mail retries up to 5 times with exponential backoff. Failed deliveries are logged in Settings → Webhooks → Delivery log.