curl -X POST https://api.mailofly.com/api/v1/suppressions/batch \
-H "Authorization: Bearer mf_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"suppressions": [
{ "email": "user1@domain.invalid", "reason": "bounce" },
{ "email": "user2@domain.invalid", "reason": "complaint" }
]
}'
{
"data": {
"added": 2,
"suppressions": [
{
"id": "sup_1",
"email": "user1@domain.invalid",
"reason": "bounce",
"created_at": "2026-09-11T14:00:00Z"
},
{
"id": "sup_2",
"email": "user2@domain.invalid",
"reason": "complaint",
"created_at": "2026-09-11T14:00:00Z"
}
]
}
}
Suppressions
Add Batch Suppressions
Bulk add multiple email addresses to the suppression list.
POST
/
api
/
v1
/
suppressions
/
batch
curl -X POST https://api.mailofly.com/api/v1/suppressions/batch \
-H "Authorization: Bearer mf_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"suppressions": [
{ "email": "user1@domain.invalid", "reason": "bounce" },
{ "email": "user2@domain.invalid", "reason": "complaint" }
]
}'
{
"data": {
"added": 2,
"suppressions": [
{
"id": "sup_1",
"email": "user1@domain.invalid",
"reason": "bounce",
"created_at": "2026-09-11T14:00:00Z"
},
{
"id": "sup_2",
"email": "user2@domain.invalid",
"reason": "complaint",
"created_at": "2026-09-11T14:00:00Z"
}
]
}
}
Import and block an array of email addresses in a single API call.
Body Parameters
array
required
Response
curl -X POST https://api.mailofly.com/api/v1/suppressions/batch \
-H "Authorization: Bearer mf_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"suppressions": [
{ "email": "user1@domain.invalid", "reason": "bounce" },
{ "email": "user2@domain.invalid", "reason": "complaint" }
]
}'
{
"data": {
"added": 2,
"suppressions": [
{
"id": "sup_1",
"email": "user1@domain.invalid",
"reason": "bounce",
"created_at": "2026-09-11T14:00:00Z"
},
{
"id": "sup_2",
"email": "user2@domain.invalid",
"reason": "complaint",
"created_at": "2026-09-11T14:00:00Z"
}
]
}
}
⌘I