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.

i

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

  • event

    Fixed value: "fbl_complaint"

  • emailId

    Unique identifier of the email that was reported.

  • timestamp

    When the complaint was processed (ISO 8601, UTC).

  • data.complainant

    Recipient who reported the email.

  • data.fromAddress

    Sender address of the reported email.

  • data.subject

    Subject of the reported email. Empty or missing when the provider redacts it and on the report page.

  • data.source

    Where 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.reason

    Only for "abuse_web": the reason picked on the report page: "spam", "unsubscribe_failed", "phishing", "offensive" or "other".