NEnetcorecloud
Suppression APIs

Add Domains to Suppression List

Changed on

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

Request

  • Base URL
    https://emailapi.netcorecloud.net/v6
  • URL
    https://emailapi.netcorecloud.net/v6/suppressions/global/domain
  • Auth
    HTTP bearer

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"
  ]
}

Changes

  • 05ceb351bd4eRevision changes
    • warning

      deleted the header request parameter on_behalf_of

    • info

      added the new optional header request parameter on-behalf-of