Skip to main content
POST
/
v3
/
contact-blacklist-rules
/
emails
Create an email blacklist rule
curl --request POST \
  --url https://api.reply.io/v3/contact-blacklist-rules/emails \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "pattern": "spam@example.com"
}
'
{
  "id": 123,
  "pattern": "<string>",
  "isGlobal": true
}

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

Request body for creating an email blacklist rule

​
pattern
string
required

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

Example:

"spam@example.com"

Response

Email blacklist rule created successfully

A blacklist rule that blocks an email pattern

​
id
integer
read-only

Unique identifier of the rule

​
pattern
string

Email pattern to blacklist

​
isGlobal
boolean
read-only

Whether this is a global (system-wide) rule