v1

latestOpenAPI 3.1.02026-07-2616459400.5 KB

Suppression APIs

Add Email(s) to Suppression List

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

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