Webhook event · Delivery

spam

Sent when the receiving mail server refuses the email as spam or for a policy reason while we deliver it.

i

Delivered as a signed POST to your webhook URL. See Setup & Events for how to verify the signature.

Payload

// Refused as spam
{
  "event": "spam",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T04:32:13.000Z",
  "data": {
    "recipientEmail": "user@example.com",
    "fromAddress": "hello@yourdomain.com",
    "reason": "550 5.7.1 Our system has detected that this message is likely unsolicited mail"
  }
}
!

Not a complaint. spam is a refusal at delivery time. When a recipient reports an email that was delivered, you get fbl_complaint instead.

Field reference

  • event

    Fixed value: "spam".

  • emailId

    ID of the email, the same one returned by POST /send.

  • timestamp

    When the event happened (ISO 8601, UTC).

  • data.recipientEmail

    Recipient email address.

  • data.fromAddress

    Sender email address.

  • data.reason

    The answer from the receiving server.