Skip to main content
POST
Create a manual suppression

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

reason/source are forced to manual_block/manual (ignored if supplied). scope is derived. bounce_category/dsn_code/meta/ group_id are not accepted on the public surface.

to
string
required

Recipient address (normalized: trim + lower-case).

from
string | null

Sender address (normalized). null ⇒ account/domain scope.

domain_id
string<uuid> | null

null ⇒ account scope.

expires_at
string<date-time> | null

Response

Idempotent — matching suppression already existed.

data
object
required

Suppression record. Schema fields hidden by the view: account_id, bounce_category, dsn_code, meta.