API Reference

Add Suppression

POST /suppressions — stop all mail to one address.

POST/suppressions

Puts one address on your account's suppression list. SendDart skips any later send to it (the send is reported as suppressed). The new row has origin: "manual" and fires a suppression.added webhook.

Adding an address that is already listed changes nothing: you get the existing row back with status 200 instead of 201, and no webhook fires.

Needs a full-access API key. A sending-only key gets 401 restricted_api_key.
Body parameters
emailstringrequired

The address to suppress.

const res = await fetch('https://www.senddart.com/api/suppressions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer mb_xxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "email": "pat@example.com"
}),
});
const data = await res.json();
console.log(data);

Response (201)

{
  "object": "suppression",
  "id": "48213",
  "email": "pat@example.com",
  "origin": "manual",
  "domain": null,
  "created_at": "2026-11-20T09:14:02.000Z"
}
The suppression object
idstringoptional

The suppression's id: a number, sent as text.

emailstringoptional

The suppressed address, in lower case.

originstringoptional

How the address got on the list: bounce (a hard bounce), complaint (marked as spam), manual (added by you, in the dashboard or with this API) or unsubscribe (the recipient opted out).

domainstring | nulloptional

null when the address is blocked for the whole account. A sending domain when the opt-out only applies to mail from that domain.

created_atstringoptional

When the address was added (ISO 8601).

A missing or invalid email returns 422 validation_error.