Resource

Email events

Opens, clicks, bounces, replies, unsubscribes.

Endpoints · 1

Read · GET

Fetch data — accept query filters, return JSON. Read-only and idempotent.

GET
List email events
/v1/email-events
/v1/email-events

Object shape

The email events object

Each event is keyed to a `sent_email_id` and a `contact_id`. Open and click events are deduped per (contact, kind, day) before insert to keep mailbox prefetchers from inflating counts.

Email events object

{
  "id": "01HZS4V8B6P9Q1R2S3T4U5V6W7",
  "sent_email_id": "01HZS3RV6W7X8Y9Z0A1B2C3D4E",
  "contact_id": "c2a8a93a-2f1c-4c5b-8f3d-9c1e3a8b5d12",
  "kind": "open",
  "occurred_at": "2026-05-01T09:18:42.000+05:30",
  "user_agent": "Mozilla/5.0 (Macintosh; ...) Safari/605.1.15",
  "ip_address": "203.0.113.7"
}

Was this page helpful?

Your vote stays in this browser. We'll use it to prioritise rewrites.