v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Contact Blacklist Rules

Bulk create email blacklist rules

<small>Requires the contacts:write scope (or a broader one that includes it).</small>

Creates multiple email blacklist rules. Non-atomic — some may succeed while others fail. Each item in the response array contains the created ID or error details.

post/v3/contact-blacklist-rules/emails/bulk

Request body

patternstring required

Email pattern to blacklist. Must be a valid email format (e.g., spam@example.com)

Example request

[
  {
    "pattern": "spam@example.com"
  }
]

Response

Array of creation results, one per input item.

Per-item error codes:

errorMeaning
2Duplicate — a rule with this pattern already exists
4InvalidPattern — pattern is not a valid email
5NotAdded — rule could not be added (other reason)
idinteger nullable

ID of the created rule, null if creation failed

errorinteger nullable

Error code if creation failed

errorDetailsstring nullable

Human-readable error description if creation failed