email.opened

A tracked open was recorded, with bot and privacy-proxy hits flagged.

POSTemail.openedWebhook

Header parameters

AIInbx-Signaturestringrequired

t=<unix seconds>,v1=<hmac>: an HMAC-SHA256 of the timestamp and the raw body, with one v1 per secret while a rotation's grace period runs.

AIInbx-Event-IDstringrequired

The event id, id in the body.

Request body

requiredapplication/json

idstringrequired

The event, evt_…. Stable across retries and replays: deduplicate on it.

matches ^[a-z]+_[0-9a-f]{32}$

typestringrequired

created_atstring<date-time>required

When the event happened.

matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

space_idstring | nullrequired

Which space a resource is in. Null is the workspace itself — what every resource of a workspace that has no spaces says.

Show properties

Any of:

string

string

null

null

dataobjectrequired

Show properties

email_idstringrequired

The email, eml_…. Retrieve it for bodies and headers.

matches ^[a-z]+_[0-9a-f]{32}$

message_idstringrequired

The RFC Message-ID, without angle brackets.

thread_idstringrequired

The conversation it belongs to.

matches ^[a-z]+_[0-9a-f]{32}$

domain_idstring | nullrequired

The domain the message went through: received on or sent from. Null when it went through a mailbox.

Show properties

Any of:

string

string

null

null

mailbox_idstring | nullrequired

The mailbox the message went through: synced from or sent with. Null when it went through a domain.

Show properties

Any of:

string

string

null

null

suppression_keystring | nullrequired

The suppression list the send named, when it named one.

Show properties

Any of:

string

string

null

null

user_agentstring | nullrequired

The client that loaded the tracking pixel.

Show properties

Any of:

string

string

null

null

botbooleanrequired

True when a proxy, security scanner or script made the hit rather than the recipient.

bot_reasonstring | nullrequired

Why: privacy_proxy is Apple Mail Privacy Protection fetching on arrival, script an HTTP library, known_bot a scanner or link expander that names itself, stale_browser a browser build nobody runs any more, too_fast within seconds of delivery, sooner than a person could act. Null when bot is false. More reasons may be added; treat one you do not know as a bot.

Show properties

Any of:

string

string

null

null

Responses

2XX

Acknowledges the delivery. Anything else, or no answer within 10 seconds, is retried; a Retry-After header is honoured over the standard backoff.

Payload

{
  "id": "string",
  "type": "email.opened",
  "created_at": "2019-08-24T14:15:22Z",
  "space_id": "string",
  "data": {
    "email_id": "string",
    "message_id": "string",
    "thread_id": "string",
    "domain_id": "string",
    "mailbox_id": "string",
    "suppression_key": "string",
    "user_agent": "string",
    "bot": true,
    "bot_reason": "privacy_proxy"
  }
}

Response

Acknowledges the delivery. Anything else, or no answer within 10 seconds, is retried; a `Retry-After` header is honoured over the standard backoff.