Event Types

Email Events

Subscribe to these events when creating webhooks:

Event	Description
email.sent	Email was successfully delivered to the SMTP server
email.failed	Email delivery failed after all retries
email.inbound	An inbound message was received and forwarded

Campaign Events

Event	Description
campaign.started	A campaign began sending
campaign.completed	A campaign finished sending all messages

Event Payload Structure

All events share a common structure:

{
  "event": "email.sent",
  "timestamp": "2026-01-01T00:00:01Z",
  "data": {
    "email_id": "uuid",
    "to": "recipient@example.com",
    "from": "sender@example.com",
    "subject": "Hello",
    "status": "sent",
    "error_message": null
  }
}

email.sent

Fired when an email is successfully delivered:

{
  "event": "email.sent",
  "data": {
    "email_id": "uuid",
    "to": "recipient@example.com",
    "status": "sent",
    "sent_at": "2026-01-01T00:00:01Z"
  }
}

email.failed

Fired when delivery fails after all retries:

{
  "event": "email.failed",
  "data": {
    "email_id": "uuid",
    "to": "recipient@example.com",
    "status": "failed",
    "error_message": "Connection refused",
    "retry_count": 3
  }
}

campaign.started

Fired when a campaign begins sending:

{
  "event": "campaign.started",
  "campaign_id": 42,
  "name": "Spring Newsletter",
  "timestamp": "2026-01-01T00:00:01Z"
}

campaign.completed

Fired when a campaign finishes sending all of its messages:

{
  "event": "campaign.completed",
  "campaign_id": 42,
  "name": "Spring Newsletter",
  "timestamp": "2026-01-01T00:00:01Z"
}