email.complained
The recipient marked the message as spam.
The recipient marked the message as spam. Rarer than a bounce and far more serious for reputation.
Payload
PropType
email_idstring
eml_…
Type
stringthread_idstring
The conversation.
Type
stringdomain_idstring | null
The domain it was sent from, or null when sent through a mailbox.
Type
string | nullmailbox_idstring | null
The mailbox it was sent through, or null when sent from a domain.
Type
string | nullsuppression_keystring | null
The list the send named — where the complaint is filed, in the send's space.
Type
string | nullrecipientsstring[]
Who complained.
Type
string[]reasonstring | null
The provider's reason, when given.
Type
string | nullHandling it
Treat a complaint as final. The address is suppressed automatically; never remove that entry to keep sending.
A rising complaint rate is what gets a sending domain throttled or blocked by the large mailbox providers, so it’s worth alerting on rather than only logging.