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"
}