Add Suppression
POST /suppressions — stop all mail to one address.
/suppressionsPuts 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.
401 restricted_api_key.emailstringrequiredThe 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"
}idstringoptionalThe suppression's id: a number, sent as text.
emailstringoptionalThe suppressed address, in lower case.
originstringoptionalHow 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 | nulloptionalnull when the address is blocked for the whole account. A sending domain when the opt-out only applies to mail from that domain.
created_atstringoptionalWhen the address was added (ISO 8601).
A missing or invalid email returns 422 validation_error.