Webhooks allow you to receive HTTP POST requests when certain events occur with your emails. Configure your webhook URL in your dashboard settings.
| Event | Description |
|---|---|
| email.sent | Email was successfully sent |
| email.delivered | Email was delivered to recipient |
| email.opened | Recipient opened the email |
| email.clicked | Recipient clicked a link |
| email.bounced | Email bounced |
| email.complained | Recipient marked as spam |
| email.unsubscribed | Recipient unsubscribed |
{
"event": "email.delivered",
"timestamp": "2024-12-22T10:30:00Z",
"data": {
"message_id": "msg_abc123xyz",
"email": "recipient@example.com",
"subject": "Welcome!",
"tags": ["welcome"],
"metadata": {}
}
}All webhook requests include a signature header for verification:
X-SendBaba-Signature: sha256=abc123...
Verify the signature by computing HMAC-SHA256 of the request body using your webhook secret.