Suppression APIs

Add Email(s) to Suppression List

Changed on

This endpoint allows you to suppress one or more email addresses and block any future delivery attempts to those addresses from your account. Suppressing email addresses is useful for managing bounces, spam complaints, or opt-out requests to ensure compliant and clean email delivery. For example: Suppressing youremailid@gmail.com will block all future delivery attempts to that address.

post/suppressions/global/email

Request

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

Headers

on-behalf-ofstring

(Optional) Use this header when making API calls on behalf of a subaccount. Required only if you’re using a master account’s API key.

Request body

recipient_emailsstring[] required

List of email addresses to be suppressed. Must be in valid email format (e.g., user@example.com). Limit: 1–1000 entries.

Example request

{
  "recipient_emails": [
    "user@example.com"
  ]
}

Response

Email(s) successfully added to suppression list.

recipient_emailsstring[] required

Example response

{
  "recipient_emails": [
    "user@example.com"
  ]
}

Changes

    • warning

      deleted the header request parameter on_behalf_of

    • info

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