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.
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
eventFixed value: "email_opened".
emailIdID of the email that was opened. Also repeated in data.emailId.
timestampWhen the open happened (ISO 8601, UTC).
data.recipientEmailWho opened it.
data.trackOnly for API / SMTP emails sent with a track: the track key.
data.campaignIdOnly for campaign emails: the campaign ID.
data.userAgentUser agent of the request that loaded the image.
data.ipIP address of that request.
data.locationCountry code of that IP, like "MY" or "US".
data.isProxyTrue when the open came through a mailbox proxy or scanner (Gmail image proxy, Apple Mail privacy), not straight from the recipient.
data.isFirstOpenTrue the first time this recipient opens this email. Can be null when it cannot be known.