Webhook event · Feedback
fbl_complaint
Sent when a recipient reports your email as spam: through a mailbox provider feedback loop (Microsoft, Yahoo, AOL), by replying to the abuse address in the X-Report-Abuse header, or on the abuse report page linked from the email.
Delivered as a signed POST to your webhook URL. See Setup & Events for how to verify the signature.
Payload
// Feedback loop (Yahoo)
{
"event": "fbl_complaint",
"emailId": "4b1f0c7e-2d9a-4e83-9b6c-1a7d5e0f3c28",
"timestamp": "2026-10-20T13:05:41.000Z",
"data": {
"complainant": "john@yahoo.com",
"fromAddress": "Acme <news@acme.com>",
"subject": "Your October deals",
"source": "fbl_yahoo"
}
}One event per email If the same email is reported more than once (for example by the feedback loop and the abuse page), you receive the event only once. The contact is marked as complained and is skipped by every campaign from then on. Complaints also show in the Bounces & Complaints page and in the feedback API.
Field reference
eventFixed value: "fbl_complaint"
emailIdUnique identifier of the email that was reported.
timestampWhen the complaint was processed (ISO 8601, UTC).
data.complainantRecipient who reported the email.
data.fromAddressSender address of the reported email.
data.subjectSubject of the reported email. Empty or missing when the provider redacts it and on the report page.
data.sourceWhere the complaint came from: "fbl_microsoft", "fbl_yahoo" (Yahoo and AOL), "fbl_other", "abuse_mailbox" (reply to the X-Report-Abuse address) or "abuse_web" (abuse report page).
data.reasonOnly for "abuse_web": the reason picked on the report page: "spam", "unsubscribe_failed", "phishing", "offensive" or "other".