Suppressions

Manage the per-account suppression list (bounces, unsubscribes, manual blocks).

The suppression list prevents emails from being sent to addresses that have bounced, unsubscribed, or been manually blocked. Bounces and unsubscribes are added automatically. Use the API to manually add or remove entries.

Endpoints

Method	Description	Permission
GET	List suppressions	suppressions.read
POST	Add suppression	suppressions.write
DELETE	Remove suppression	suppressions.write

List Suppressions

GET /api/v1/suppressions

Request

Response

{
  "success": true,
  "data": [
    {
      "email": "bounced@example.com",
      "reason": "bounce",
      "detail": "550 5.1.1 User unknown",
      "created_at": "2026-03-15T08:00:00Z"
    },
    {
      "email": "unsubscribed@example.com",
      "reason": "unsubscribe",
      "detail": null,
      "created_at": "2026-03-16T12:30:00Z"
    }
  ],
  "meta": { "page": 1, "per_page": 50, "total": 23, "total_pages": 1 }
}

json

Add / Remove Suppression

POST /api/v1/suppressions • DELETE /api/v1/suppressions/:email

Add a suppression

Response (add)

{
  "success": true,
  "data": {
    "email": "block@example.com",
    "reason": "manual",
    "detail": "Customer requested no further emails",
    "created_at": "2026-03-18T10:00:00Z"
  }
}

json

Response (remove)

{
  "success": true,
  "message": "Suppression removed for block@example.com"
}

json