sendsend.email
Sign inStart building

Add a suppression

POST/v1/suppressions

Stops all mail to an address. The suppression list belongs to your organization, so every project shares it. Addresses are stored in lower case. Adding an address that is already listed re-activates it.

Required scope: suppressions:manage

Request body

FieldType
addressrequiredstring
reasonoptionalstring

Unknown fields are rejected, so a typo never silently does nothing.

Example

curl -X POST 'https://api.sendsend.email/v1/suppressions' \
  -H "Authorization: Bearer $SENDSEND_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "address": "maria@example.com",
  "reason": "asked to unsubscribe"
}'

Response 201

{
  "id": "sup_4Gh2…",
  "object": "suppression",
  "address": "maria@example.com",
  "reason": "bounce",
  "source": "provider",
  "created_at": "2026-10-06T15:00:00.000Z"
}

Errors

StatusCodeWhen
400validation_errorThe request body or parameters are invalid. The message says which field.
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.