Suppressions API

Manage the suppression list to prevent sending to bounced or complained addresses.

GET /v1/suppressions

GET/v1/suppressions

List all suppressed email addresses. Requires full-access key. Addresses are automatically added when a permanent bounce or complaint occurs.

response — 200 OK

{
  "suppressions": [
    {
      "id": "b8c9d0e1-cdef-4012-3456-888888888888",
      "email": "invalid@example.com",
      "reason": "BOUNCE",
      "createdAt": "2026-03-11T00:00:00.000Z"
    }
  ]
}

POST /v1/suppressions

POST/v1/suppressions

Manually suppress an email address. Requires full-access key and verified email. Useful for proactively blocking known-bad addresses.

Request body

Name	Type	Description
email*	string	Email address to suppress
reason	"BOUNCE" \| "COMPLAINT" \| "MANUAL"	Default: "MANUAL"

Errors

403 — Email not verified or scoped key
409 — Address already suppressed

DELETE /v1/suppressions/:id

DELETE/v1/suppressions/:id

Remove a suppression, allowing sends to the address again. Requires full-access key. Use with caution — sending to previously bounced addresses can harm your sender reputation.

response — 200 OK

{ "deleted": true }