Suppression list

Addresses that are blocked from receiving mail — populated automatically on hard bounce or spam complaint, or added manually.

Add a suppression

POST

/suppressions

Authorizations

Authorization

string

header

required

API key for your workspace, scoped to suppressions:manage. Pass it as a Bearer token in the Authorization header.

Body · application/json

email

string

reason

string

Add a suppression

curl https://api.mailcraft.host/v1/suppressions \
  -X POST \
  -H 'Authorization: Bearer sk_live_...' \
  -H 'Content-Type: application/json' \
  -d '{ "email": "[email protected]", "reason": "manual" }'

{
  "data": {
    "id": 11,
    "email": "[email protected]",
    "reason": "manual",
    "source": "api",
    "created_at": "2026-09-22T14:24:00.000000Z"
  }
}

List suppressions

GET

/suppressions

Authorizations

Authorization

string

header

required

API key for your workspace, scoped to suppressions:manage. Pass it as a Bearer token in the Authorization header.

List suppressions

curl https://api.mailcraft.host/v1/suppressions \
  -H 'Authorization: Bearer sk_live_...'

{
  "data": [
    { "id": 11, "email": "[email protected]", "reason": "manual", "source": "api" }
  ]
}

Remove a suppression

DELETE

/suppressions/{suppression}

Authorizations

Authorization

string

header

required

API key for your workspace, scoped to suppressions:manage. Pass it as a Bearer token in the Authorization header.

Remove a suppression

curl https://api.mailcraft.host/v1/suppressions/11 \
  -X DELETE \
  -H 'Authorization: Bearer sk_live_...'

(empty body)