Skip to main content
POST
/
suppressions
curl -X POST https://api.unosend.co/suppressions \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "donotcontact@example.com",
    "reason": "manual"
  }'

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "donotcontact@example.com",
    "reason": "manual",
    "created_at": "2024-01-15T10:30:00.000Z"
  }
}

​
Request Body

​
email
string
required
Email address to suppress
​
reason
string
default:"manual"
Reason for suppression:
  • hard_bounce - Invalid email address
  • spam_complaint - Spam report
  • manual - Manual suppression (default)
  • unsubscribe - Unsubscribed

​
Response

​
id
string
Unique suppression identifier
​
email
string
Suppressed email address (lowercase)
​
reason
string
Reason for suppression
​
created_at
string
ISO 8601 timestamp
curl -X POST https://api.unosend.co/suppressions \
  -H "Authorization: Bearer un_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "donotcontact@example.com",
    "reason": "manual"
  }'

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "donotcontact@example.com",
    "reason": "manual",
    "created_at": "2024-01-15T10:30:00.000Z"
  }
}
If the email is already suppressed, the existing suppression will be updated with the new reason.