Skip to main content
Webhooks allow your application to receive real-time HTTP notifications when events occur in SendKit. Instead of polling the API, SendKit pushes event data to your endpoint as it happens.

​
How it works

1

Register a webhook endpoint

Provide an HTTPS URL where SendKit will send event notifications.
2

Choose your events

Subscribe to specific events (e.g. email.delivered) or use the wildcard * to receive all events.
3

Receive and verify

SendKit sends a POST request with a JSON payload and an HMAC-SHA256 signature for verification.

​
Payload format

Every webhook delivery is a POST request with a JSON body: 
{
  "type": "email.delivered",
  "data": {
    "email_id": "em_abc123",
    "from": "hello@yourdomain.com",
    "to": "user@example.com",
    "subject": "Welcome to SendKit",
    "created_at": "2026-03-02T12:00:00+00:00"
  },
  "created_at": "2026-03-02T12:00:00+00:00"
}

​
Available events

SendKit supports two categories of events:
CategoryEvents
Emailemail.sent, email.delivered, email.bounced, email.complained, email.opened, email.clicked, email.rejected, email.failed, email.delivery_delayed
Contactcontact.created, contact.updated, contact.deleted

Event reference

See the full list of events with payload examples.