Webhook event · Tracking

email_opened

Sent when a recipient opens an email with open tracking on. Includes the device, IP, country and whether the open came through a proxy.

i

Delivered as a signed POST to your webhook URL. See Setup & Events for how to verify the signature.

Payload

// Opened (API / SMTP email)
{
  "event": "email_opened",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T05:12:44.000Z",
  "data": {
    "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
    "recipientEmail": "john.doe@example.com",
    "track": "a41f9c0e7b2d58e6",
    "userAgent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15",
    "ip": "203.112.45.78",
    "location": "MY",
    "isProxy": false,
    "isFirstOpen": true
  }
}
!

Proxy opens are sent too. Opens through a proxy still send this event, marked with isProxy: true. Filter on it if you only want opens you are sure came from a person.

Field reference

  • event

    Fixed value: "email_opened".

  • emailId

    ID of the email that was opened. Also repeated in data.emailId.

  • timestamp

    When the open happened (ISO 8601, UTC).

  • data.recipientEmail

    Who opened it.

  • data.track

    Only for API / SMTP emails sent with a track: the track key.

  • data.campaignId

    Only for campaign emails: the campaign ID.

  • data.userAgent

    User agent of the request that loaded the image.

  • data.ip

    IP address of that request.

  • data.location

    Country code of that IP, like "MY" or "US".

  • data.isProxy

    True when the open came through a mailbox proxy or scanner (Gmail image proxy, Apple Mail privacy), not straight from the recipient.

  • data.isFirstOpen

    True the first time this recipient opens this email. Can be null when it cannot be known.