Docs
DashboardGet API key
API · suppressions

Add a suppression

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

01 Body

emailstringRequired
The address to suppress.
reasonstringOptional
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 automaticDrin 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.

02 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" }'

03 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"
}