For the complete documentation index, see llms-docs.txt or the site index llms.txt. Full docs corpus: llms-full-docs.txt. Prefer the markdown version of this page at /docs/webhooks/emails/complained.md. Product capabilities: skill.md. Docs MCP: /docs/mcp. Site MCP: /mcp.

email.complained

Webhook event triggered when a recipient marks an email as spam.

{
  "id": "whev_01h…",
  "type": "email.complained",
  "created_at": "2026-07-22T12:00:00.000Z",
  "data": {
    "email_id": "em_123456789",
    "from": "sender@example.com",
    "to": ["recipient@example.com"],
    "subject": "Hello World",
    "status": "spam",
    "error": {
      "message": "Feedback loop: spam complaint"
    }
  }
}

The email.complained event is triggered when a feedback loop reports spam.

Event Details

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

type string

The event type that triggered the webhook (email.complained).

created_at string

ISO 8601 timestamp when the webhook event was created.

data object

Includes standard email fields; status is spam and error may include FBL details.

Handling this event

When your endpoint receives an email.complained event, you might want to:

  • Immediately suppress the recipient.
  • Review content or list hygiene.

Learn More

Was this page helpful?

Edit this page