Simplifyd Cloud
SmailSuppressionsSuppressions

Suppressions

Prevent delivery to addresses that should not receive email.

Suppressions are account-scoped recipient blocks. If a send includes a suppressed recipient, Smail records the email with status suppressed, does not queue delivery, and emits email.suppressed webhooks.

Add a suppression

curl https://api.smail.dev/api/v1/suppressions \
  -H "Authorization: Bearer $SMAIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "reason": "manual",
    "note": "Requested not to receive product emails"
  }'

Remove a suppression

curl -X DELETE https://api.smail.dev/api/v1/suppressions/user%40example.com \
  -H "Authorization: Bearer $SMAIL_TOKEN"

SDK examples

await smail.suppressions.create({
  email: "user@example.com",
  reason: "manual",
});

const { suppressions } = await smail.suppressions.list();
suppression, err := client.Suppressions.Create(ctx, smail.CreateSuppressionRequest{
    Email:  "user@example.com",
    Reason: "manual",
})