Bounces and complaints

Report a complaint

POST /api/v1/notification/feedback

A spam or abuse report about a message. The contact is marked as having reported spam. An admin token may report any message; a customer's token, only its own.

Request body application/x-www-form-urlencoded
message_id string required
The Message-ID the email was sent with.
type string required
One of: spam, abuse.
description string
The report.
Responses
200 The complaint, as recorded (also when it was recorded already).
400 message_id or type is missing or wrong, or no message of the token's account was sent with this id.
401 The token is missing or wrong (Unauthenticated.), or its user may not act on this object (Unauthorized). Without the Accept: application/json header, a missing or wrong token answers with a redirect to the sign-in page instead.
Report a complaint
1 2 3 4 5 6
curl -X POST 'https://your-domain/api/v1/notification/feedback' \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  --data-urlencode 'message_id=201637442604422402.6199642caf7f3@example.com' \
  --data-urlencode 'type=abuse' \
  --data-urlencode 'description=Reported as spam by the recipient'
Response
{
    "id": 812,
    "runtime_message_id": "201637442604422402.6199642caf7f3@example.com",
    "message_id": null,
    "customer_id": 1,
    "tracking_log_id": 88231,
    "feedback_type": "abuse",
    "raw_feedback_content": "Reported as spam by the recipient",
    "created_at": "2026-11-14T10:00:00.000000Z",
    "updated_at": "2026-11-14T10:00:00.000000Z"
}