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

Body

string

required

The address to suppress.

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

import { DrinClient } from "@drin00/sdk";

const drin = new DrinClient({ apiKey: process.env.DRIN_API_KEY });

await drin.suppressions.create({
  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"
}

Overview

Emails

Domains

Inboxes

Threads

Inbound

Webhooks

Suppressions

Contacts

Templates

Metrics

API keys

Add a suppression

Body

Request

Response

​Body

​Request

​Response

Body

Request

Response