Domains and events

Suppression list

Addresses that can't or don't want to receive your mail go on a list, and Chebu skips them.

Sending to addresses that bounce or complain hurts your domain's reputation, and every sender's. Chebu adds an address to your workspace's suppression list automatically, and later emails to it are skipped with an email.suppressed event.

Reason	Added when
`hard_bounce`	The receiving server says the address doesn't exist.
`complaint`	The recipient marks your email as spam.
`soft_bounce`	The address bounces temporarily three times within 7 days.
`manual`	You add it through the API, for example after an unsubscribe.

List suppressions

GET/suppressions

Request

curl https://api.chebu.io/suppressions?limit=20 \
  -H "Authorization: Bearer $CHEBU_API_KEY"

JSON

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "email": "[email protected]",
      "reason": "hard_bounce",
      "created_at": "2026-09-27T10:04:16.120Z",
      "email_id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c"
    }
  ]
}

Page with limit and after as for emails. To check one address, GET /suppressions/{email}. It returns the entry, or 404 not_found if the address isn't suppressed. URL-encode the address in the path.

Add an address

POST/suppressions

Request

curl -X POST https://api.chebu.io/suppressions \
  -H "Authorization: Bearer $CHEBU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]" }'

JSON

{
  "email": "[email protected]",
  "reason": "manual",
  "created_at": "2026-09-27T12:00:00.000Z",
  "email_id": null
}

Remove an address

Remove an address only when you know it works again, for example after the person fixes a full mailbox or asks to hear from you. Sending to a dead address again will bounce and put it straight back.

DELETE/suppressions/nobody%40example.com

Request

curl -X DELETE https://api.chebu.io/suppressions/nobody%40example.com \
  -H "Authorization: Bearer $CHEBU_API_KEY"

JSON

{
  "email": "[email protected]",
  "deleted": true
}