Webhooks Overview | docs.do.dev

Webhooks

Get instant notifications when emails are delivered, opened, clicked, or bounce. Build reactive systems that respond to email events in real-time.

Want to be notified when this feature launches?Let us know

Planned Features

Event Types

Event	Description
`email.sent`	Email handed off to receiving server
`email.delivered`	Email confirmed in inbox
`email.opened`	Recipient opened the email
`email.clicked`	Recipient clicked a link
`email.bounced`	Email bounced (hard or soft)
`email.complained`	Recipient marked as spam
`email.unsubscribed`	Recipient clicked unsubscribe

Webhook Configuration

# Create a webhook endpoint
POST /v1/webhooks
{
  "url": "https://yourdomain.com/webhooks/send",
  "events": ["email.delivered", "email.bounced", "email.complained"],
  "secret": "whsec_..."
}

Payload Example

{
  "id": "evt_01HXYZ123456789",
  "type": "email.delivered",
  "created_at": "2025-01-13T10:30:00Z",
  "data": {
    "email_id": "email_01HXYZ123456789",
    "to": "user@example.com",
    "from": "hello@mail.yourdomain.com",
    "subject": "Welcome!",
    "delivered_at": "2025-01-13T10:30:03Z"
  }
}

Security

Signature verification
Timestamp validation
IP allowlisting
Retry on failure