Skip to main content
POST
/
v3
/
contact-blacklist-rules
/
emails
/
bulk
Bulk create email blacklist rules
curl --request POST \
  --url https://api.reply.io/v3/contact-blacklist-rules/emails/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
[
  {
    "pattern": "spam@example.com"
  }
]
'
[
  {
    "id": 123,
    "error": 123,
    "errorDetails": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Body

application/json
​
pattern
string
required

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

Example:

"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)
​
id
integer | null
read-only

ID of the created rule, null if creation failed

​
error
integer | null
read-only

Error code if creation failed

​
errorDetails
string | null
read-only

Human-readable error description if creation failed