Skip to main content
Manually add an address to the project’s block list. Once suppressed, any send to that address is dropped before it leaves the pipeline. POST /v1/suppressions

​
Body

​
email
string
required
The address to suppress.
​
reason
string
Why it’s being added. Manual additions are recorded as manual. Bounces and complaints are added automatically with hard_bounce / complaint.
Bounces and complaints are automatic. Drin suppresses an address on its own when it hard-bounces or files a spam complaint. Use this endpoint for addresses you already know you should not contact.

​
Request

curl https://api.drin.run/v1/suppressions \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "do-not-mail@example.com", "reason": "manual" }'

​
Response

Returns 201 Created with the suppression entry. Adding an address that is already suppressed is safe and idempotent.
201 Created
{
  "email": "do-not-mail@example.com",
  "reason": "manual",
  "createdAt": "2026-06-02T17:30:00.000Z"
}