API Reference · Suppressions

Add suppression

Manually suppress an address so it's skipped on every future send.

POST/v1/suppressions

Headers

Authorizationstringrequired

Your API key as a bearer token: Bearer rk_your_api_key. You can also use the X-Api-Key header.

Body parameters

emailstringrequired

The address to suppress.

Request

curl -X POST https://api.raanse.com/v1/suppressions \
  -H "Authorization: Bearer rk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
        "email": "blocked@example.com"
      }'

Response

201

{
  "success": true,
  "message": "Resource created",
  "statusCode": 201,
  "data": { "id": "01JABCDXYZ0000000000000000", "email": "blocked@example.com", "reason": "Manual", "createdAt": "2026-07-02T12:00:00Z" }
}