API ReferenceWebhooks

Webhooks Overview

Webhooks enable real-time notifications about your email activity. Instead of polling our API for delivery status, we push event data to your server as it happens.

Valid Event Types

Email Events

email_sentHanded off to sending provider.

email_deliveredConfirmed delivery by recipient server.

email_openedRecipient opened the email.

email_clickedRecipient clicked a tracked link.

email_bouncedPermanent or temporary bounce recorded.

email_complainedRecipient marked email as spam.

email_suppressedEmail suppressed due to prior bounce/complaint.

email_failedEmail failed to send.

email_delayedEmail delayed due to prior bounce/complaint.

email_rejectedEmail rejected due to prior bounce/complaint.

email_unsubscribedRecipient unsubscribed from email.

Domain Resource Events

domain_createdA new sending domain was added.

domain_deletedA sending domain was removed.

domain_verifiedDomain DNS verification succeeded.

Domain Group Events

domain_group_createdA new domain group was created.

domain_group_updatedA domain group was updated.

domain_group_deletedA domain group was removed.

Event Payload Structure

{
  "id": "evt_123456789",
  "type": "email_delivered",
  "created": "2025-09-16T19:04:22.043Z",
  "data": {
    "messageId": "msg_0100019a3908b26b",
    "recipient": "hello@example.com",
    "timestamp": 1726513462,
    "metadata": {
      "campaign_id": "summer_sale_2024"
    }
  }
}