email.bounced
Delivery to one or more recipients failed; a dead address is suppressed.
email.bouncedWebhookAIInbx-Signaturestringrequiredt=<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-IDstringrequiredThe event id, id in the body.
application/jsonidstringrequiredThe event, evt_…. Stable across retries and replays: deduplicate on it.
typestringrequiredcreated_atstring<date-time>requiredWhen the event happened.
space_idstring | nullrequiredWhich space a resource is in. Null is the workspace itself — what every resource of a workspace that has no spaces says.
Show propertiesHide properties
stringnulldataobjectrequiredShow propertiesHide properties
email_idstringrequiredThe email, eml_…. Retrieve it for bodies and headers.
message_idstringrequiredThe RFC Message-ID, without angle brackets.
thread_idstringrequiredThe conversation it belongs to.
domain_idstring | nullrequiredThe domain the message went through: received on or sent from. Null when it went through a mailbox.
Show propertiesHide properties
stringnullmailbox_idstring | nullrequiredThe mailbox the message went through: synced from or sent with. Null when it went through a domain.
Show propertiesHide properties
stringnullsuppression_keystring | nullrequiredThe suppression list the send named, when it named one.
Show propertiesHide properties
stringnullrecipientsstring<email>[]requiredWhich recipients bounced: the message did not reach them, and nothing will try again.
bouncesobject[]One entry per address in recipients, in the same order: why it bounced, and whether it was suppressed. Absent from an event recorded before this field existed, which GET /events and a replay still return as it was.
Show propertiesHide properties
objectaddressstring<email>requiredcausestringrequiredWhy the mail did not arrive. bad_address: the address does not exist or no longer takes mail. mailbox_full: it exists and is over its quota. sender_auth: the receiving side would not take it as from the sending domain — DMARC, SPF or DKIM failed — which is fixed in the domain's DNS records. blocked: refused by the receiving side's policy — a blocklist, the sender's reputation, a recipient that only takes mail from some senders. content: the message itself — its content, an attachment, its size. expired: retried until the provider gave up. routing: no route to the recipient, a loop. unknown: none of these could be read from what was said. More causes may be added; treat one you do not know as unknown.
bad_addressmailbox_fullsender_authblockedcontentexpiredroutingunknownsuppressedbooleanrequiredTrue when the address is dead and went on the workspace's * suppression list, so the next send to it never leaves. Only a hard bounce of a bad_address, or one nothing explains, is. Not SES refusing the send off its own suppression list: that reports bad_address without suppressing.
permanentbooleanrequiredTrue when the provider classed the bounce as hard — it gave up for good, as SES's Permanent or a 5.x status says. False for a soft one, which the provider also stopped retrying. Not whether the address is dead: a hard bounce can be a blocklist or the sender's own DMARC. Read bounces for that.
reasonstringrequiredThe provider's classification: Permanent/General from SES, the status (5.1.1) from a delivery report.
Acknowledges the delivery. Anything else, or no answer within 10 seconds, is retried; a Retry-After header is honoured over the standard backoff.