Événement webhook · Feedback

fbl_complaint

Envoyé lorsqu'un destinataire signale votre e-mail comme spam : via la feedback loop d'un fournisseur de messagerie (Microsoft, Yahoo, AOL), en répondant à l'adresse d'abus de l'en-tête X-Report-Abuse, ou sur la page de signalement d'abus liée depuis l'e-mail.

i

Envoyé sous forme de requête POST signée vers votre URL de webhook. Consultez Configuration et événements pour savoir comment vérifier la 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"
  }
}
!

Un événement par e-mail Si le même e-mail est signalé plusieurs fois (par exemple par la feedback loop et par la page d'abus), vous ne recevez l'événement qu'une seule fois. Le contact est marqué comme complained et toutes les campagnes l'ignorent désormais. Les plaintes apparaissent aussi sur la page Bounces & Complaints et dans l'API feedback.

Référence des champs

  • event

    Valeur fixe : "fbl_complaint"

  • emailId

    Identifiant unique de l'e-mail signalé.

  • timestamp

    Date de traitement de la plainte (ISO 8601, UTC).

  • data.complainant

    Destinataire qui a signalé l'e-mail.

  • data.fromAddress

    Adresse de l'expéditeur de l'e-mail signalé.

  • data.subject

    Objet de l'e-mail signalé. Vide ou absent lorsque le fournisseur le masque et sur la page de signalement.

  • data.source

    Origine de la plainte : "fbl_microsoft", "fbl_yahoo" (Yahoo et AOL), "fbl_other", "abuse_mailbox" (réponse à l'adresse X-Report-Abuse) ou "abuse_web" (page de signalement d'abus).

  • data.reason

    Uniquement pour "abuse_web" : le motif choisi sur la page de signalement : "spam", "unsubscribe_failed", "phishing", "offensive" ou "other".