Bounce House

Every time you send to an address that has already hard-bounced or filed a spam complaint, Gmail, Outlook, and other mailbox providers notice. They use this as a signal that you're not maintaining clean lists, and they respond by downgrading your sender reputation. Once your reputation drops far enough, your legitimate email starts landing in spam for everyone, not just the problematic addresses.

Your sending providers each maintain their own suppression lists, but they don't share them with each other. If an address hard-bounces on SendGrid, Postmark doesn't know about it, and you'll keep sending to it there. Bounce House maintains a single suppression list across all of your connected providers. When any provider reports a hard bounce or spam complaint, the address is suppressed everywhere. You can also import existing lists in bulk, check individual addresses before sending, and export the full list.

List suppressed addresses

curl "https://api.bouncehouse.cloud/api/accounts/me/suppression?reason=hard_bounce&limit=50" \
  -H "Authorization: Bearer bh_your_key"

Returns [{id, email_address, reason, bounce_type, provider, created_at}, ...]

Parameters:

email — search for a specific address
reason — filter by reason
limit — max 200, default 50

Check an address

curl "https://api.bouncehouse.cloud/api/accounts/me/suppression/check?email=user@example.com" \
  -H "Authorization: Bearer bh_your_key"

Returns {suppressed: true, reason: "hard_bounce"} or {suppressed: false}.

Add manually

curl -X POST https://api.bouncehouse.cloud/api/accounts/me/suppression \
  -H "Authorization: Bearer bh_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email_address": "bad@example.com", "reason": "manual", "bounce_type": "hard"}'

Bulk import

curl -X POST https://api.bouncehouse.cloud/api/accounts/me/suppression/bulk \
  -H "Authorization: Bearer bh_your_key" \
  -H "Content-Type: application/json" \
  -d '{"entries": [{"email_address": "a@example.com", "reason": "hard_bounce"}, ...]}'

Returns {imported, skipped}.

Export

curl https://api.bouncehouse.cloud/api/accounts/me/suppression/export \
  -H "Authorization: Bearer bh_your_key"

Returns all suppressed addresses (no limit).

Remove from suppression

curl -X DELETE https://api.bouncehouse.cloud/api/accounts/me/suppression/{entry_id} \
  -H "Authorization: Bearer bh_your_key"

Automatic population

When provider webhooks report a hard bounce or spam complaint, the address is automatically added to your suppression list. This works across all connected providers.

Suppression Lists