API Reference
Remove Batch Suppressions
POST /suppressions/batch/remove — remove up to 1,000 suppressions by id or address.
POST
/suppressions/batch/removeRemoves many suppressions at once. Send ids, emails, or both (up to 1,000 entries in total). An address removes every row for it, as in Remove Suppression. The response lists the rows that were removed; anything that matched nothing is simply left out. One suppression.removed webhook fires per removed row.
Needs a full-access API key. A sending-only key gets
401 restricted_api_key.Body parameters
idsstring[]optionalSuppression ids to remove.
emailsstring[]optionalAddresses to remove.
const res = await fetch('https://www.senddart.com/api/suppressions/batch/remove', {
method: 'POST',
headers: {
'Authorization': 'Bearer mb_xxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"emails": ["pat@example.com"],
"ids": ["48214"]
}),
});
const data = await res.json();
console.log(data);Response
{
"object": "list",
"data": [
{
"object": "suppression",
"id": "48213",
"email": "pat@example.com",
"origin": "manual",
"domain": null,
"created_at": "2026-11-20T09:14:02.000Z"
},
{
"object": "suppression",
"id": "48214",
"email": "lee@example.com",
"origin": "manual",
"domain": null,
"created_at": "2026-11-21T08:02:11.000Z"
}
]
}Sending neither list, a list that is not all strings, or more than 1,000 entries returns 422 validation_error.