API

Eventsv1

Query delivery and engagement events for audit, support, and analytics.

Overview

Events are the queryable log of what happened to your mail.

  • Use Webhooks for real-time streaming.
  • Use Events for backfills, audits, and support workflows.

Use both

A typical production setup uses webhooks to process live outcomes and events for occasional reconciliation.

Endpoints

GET Request
Bearer
GET/v1/events/messages

Fetch message-level events (per recipient).

GET Request
Bearer
GET/v1/events/transmissions

Fetch transmission-level events and status.

Querying patterns

  • Use time-bounded queries when possible.
  • Use Pagination to backfill reliably.
  • Combine filters (recipient, transmission id, status) to reduce scan size.

Next