email.complained
Webhook event triggered when a recipient marks an email as spam.
The email.complained event is triggered when a recipient marks an email as spam or files a complaint.
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 (e.g., email.complained).
created_at string
ISO 8601 timestamp when the webhook event was created.
data object
Contains the event-specific details such as email ID and recipient info.
Handling this event
When your endpoint receives an email.complained event, you might want to:
- Immediately remove the recipient from your mailing list.
- Log the complaint for reputation monitoring.
- Investigate the source of the complaint.
{
"type": "email.complained",
"created_at": "2023-01-01T12:00:00Z",
"data": {
"email_id": "em_123456789",
"to": ["recipient@example.com"],
"timestamp": "2023-01-01T12:00:00Z"
}
}Learn More
Was this page helpful?