v1

latestOpenAPI 3.1.02026-07-2616459400.5 KB

Suppression APIs

Add Domains to Suppression List

Adds one or more domains to the suppression list. Once added, any email addresses belonging to these domains will be blocked from receiving further communications from your account. This is typically used to suppress domains that bounce frequently, are spam traps, or belong to users who have requested to never receive emails from your brand. For example, Suppressing example.com will block emails to user@example.com. The system automatically removes the www. prefix if present.

post/suppressions/global/domain

Headers

on_behalf_ofstring

Example:subaccount_username

Use this header when making requests on behalf of a subaccount. Required only when using a master account's API key.

Request body

domainsstring[] required

List of domains to suppress. Must be valid domain strings (e.g., example.com). Limit 1 to 1000. The system strips www. prefix automatically.

Example request

{
  "domains": [
    "example.com"
  ]
}

Response

Domains successfully added to suppression list.

domainsstring[] required

Example response

{
  "domains": [
    "example.com"
  ]
}