Suppressions

Suppressions prevent sending to recipients that hard-bounced or complained. Sending to a suppressed address returns a validation error until the address is removed.

Last updated May 13, 2026

The suppression object

{
  "object": "suppression",
  "email_address": "user@example.com",
  "reason": "hard_bounce",
  "created_at": "2026-05-13T10:00:00.000Z"
}

Field	Type	Description
email_address	string	Suppressed recipient email address.
reason	string	One of `hard_bounce`, `complaint`, or `manual`.
created_at	string	ISO 8601 timestamp.

List suppressions

GET /v1/suppressions

Scope: suppressions:read. Supports pagination with cursor and limit.

{
  "data": [
    {
      "object": "suppression",
      "email_address": "user@example.com",
      "reason": "hard_bounce",
      "created_at": "2026-05-13T10:00:00.000Z"
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "limit": 25
  }
}

Remove a suppression

DELETE /v1/suppressions/:email

Scope: suppressions:write. Removes a suppressed address after you have confirmed that sending is safe again.

Returns 204 on success or 404 if the address is not currently suppressed.