Skip to main content

Features

Webhooks

Get real-time POST notifications for every email event, including delivered, bounced, opened, and clicked. Turn your email pipeline into an event stream.

Know what happens to every email

Sending is only half the story. mailkube pushes a signed webhook to your endpoint the instant something happens to a message, whether it’s delivered, bounced, opened, or clicked, so your systems stay in sync without polling the API.

How it works

  1. Create a webhook endpoint. Point mailkube at an HTTPS URL in your dashboard
  2. Subscribe to events. Pick exactly which event types you want to receive
  3. Receive signed POSTs. Every matching event triggers a real-time POST with a structured JSON payload

Events you can subscribe to

  • email.delivered. The receiving server accepted the message
  • email.bounced. A hard bounce; the address is unreachable
  • email.delivery_delayed. A soft, transient failure that will be retried
  • email.opened. The recipient opened the message
  • email.clicked. The recipient clicked a tracked link
  • email.suppressed. A send was dropped against your suppression list
  • domain.status. A sending domain’s verification or status changed

Example payload

Every event is delivered as a structured JSON object:

{
  "event": "email.delivered",
  "message_id": "msg_a1b2c3d4",
  "recipient": "user@example.com",
  "subject": "Your order has shipped",
  "timestamp": "2025-04-12T10:32:00Z",
  "metadata": { "order_id": "1234" }
}

Use cases

  • Suppression sync. Remove hard-bounced and complained addresses from your lists automatically
  • CRM updates. Mark contacts as engaged on open and click, or flag them on bounce
  • Automation. Trigger workflows the moment an email is delivered or opened
  • Domain monitoring. React immediately when a sending domain’s status changes

Reliability

mailkube queues and retries webhook delivery. If your endpoint is temporarily unavailable, you won’t lose events. Each delivery attempt is logged and visible in your dashboard.

Security

Webhook payloads are signed with HMAC-SHA256. Verify the X-Mailkube-Signature header to ensure requests are genuine before processing.

What’s next