API Reference
Add Batch Suppressions
POST /suppressions/batch/add — suppress up to 1,000 addresses at once.
POST
/suppressions/batch/addAdds up to 1,000 addresses in one request, each with origin: "manual". The response lists the rows that were added and, separately, every address that was not, with the reason. One suppression.added webhook fires per added row.
Needs a full-access API key. A sending-only key gets
401 restricted_api_key.Body parameters
emailsstring[]requiredThe addresses to suppress. At most 1,000.
const res = await fetch('https://www.senddart.com/api/suppressions/batch/add', {
method: 'POST',
headers: {
'Authorization': 'Bearer mb_xxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"emails": ["pat@example.com", "lee@example.com", "not-an-address"]
}),
});
const data = await res.json();
console.log(data);Response
{
"object": "list",
"data": [
{
"object": "suppression",
"id": "48214",
"email": "lee@example.com",
"origin": "manual",
"domain": null,
"created_at": "2026-11-21T08:02:11.000Z"
}
],
"skipped": [
{ "email": "not-an-address", "reason": "invalid" },
{ "email": "pat@example.com", "reason": "already_listed" }
]
}| `reason` | Meaning |
|---|---|
invalid | Not an email address. |
duplicate | The same address appears earlier in this request. |
already_listed | The address was already on your suppression list. |
A missing emails array or more than 1,000 entries returns 422 validation_error.