v1

latestOpenAPI 3.1.02026-07-26359254.7 MB
Contact Blacklist Rules

Bulk create domain blacklist rules

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

Creates multiple domain 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/domains/bulk

Request body

patternstring required

Domain pattern to blacklist. Must be a valid domain format (e.g., example.com, spam-domain.net)

Example request

[
  {
    "pattern": "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 domain
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