API Reference

Add Batch Suppressions

POST /suppressions/batch/add — suppress up to 1,000 addresses at once.

POST/suppressions/batch/add

Adds 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[]required

The 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
invalidNot an email address.
duplicateThe same address appears earlier in this request.
already_listedThe address was already on your suppression list.

A missing emails array or more than 1,000 entries returns 422 validation_error.