Suppression Lists

A suppression is an email address that is blocked from receiving your emails. Taifa Mail maintains a suppression list per account to prevent you from sending to addresses that would damage your sender reputation.

Why suppressions matter

Sending to addresses that have previously bounced, complained, or unsubscribed hurts your domain's reputation with mailbox providers. A poor reputation means more of your email lands in spam -- even for engaged recipients. The suppression list is your safety net.

Automatic suppressions

The following events automatically add an address to your suppression list:

You do not need to take any action for these. Taifa Mail handles them automatically.

Manual suppressions

Via the dashboard

1. Go to Suppressions in the sidebar.
2. Click Add Suppression.
3. Enter the email address and an optional reason.
4. Click Save.

Bulk import via CSV

1. Go to Suppressions.
2. Click Import CSV.
3. Upload a CSV file with one email address per line (no header required). Lines without an @ are skipped, and addresses already on the list are left as-is.

Via the API

The suppressions API is served under /v1/suppressions. The address field is named email_address, and reason is optional - it defaults to manual when omitted.

Add a suppression:

curl -X POST https://govconnect.ke/v1/suppressions \
  -H "Authorization: Bearer tfm_k_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email_address": "bad-address@example.com",
    "reason": "manual"
  }'

Adding an address that is already suppressed returns 409 Conflict.

List suppressions:

curl "https://govconnect.ke/v1/suppressions?page=0&limit=50" \
  -H "Authorization: Bearer tfm_k_YOUR_API_KEY"

The list is paginated. page is zero-based, limit accepts 1-200 (default 50). An optional search parameter filters by a substring of the address.

Response:

{
  "items": [
    {
      "id": "b1f7c0a2-3d4e-4f5a-9b6c-7d8e9f0a1b2c",
      "email_address": "bad-address@example.com",
      "reason": "bounce",
      "created_at": "2026-04-01T08:30:00Z"
    },
    {
      "id": "c2e8d1b3-4e5f-5a6b-0c7d-8e9f0a1b2c3d",
      "email_address": "former-subscriber@example.com",
      "reason": "unsubscribe",
      "created_at": "2026-04-03T14:12:00Z"
    }
  ],
  "total": 2,
  "page": 0,
  "limit": 50
}

Remove a suppression:

curl -X DELETE https://govconnect.ke/v1/suppressions/b1f7c0a2-3d4e-4f5a-9b6c-7d8e9f0a1b2c \
  -H "Authorization: Bearer tfm_k_YOUR_API_KEY"

When to remove a suppression

Only remove a suppression if you are certain that:

1. The email address is valid and currently accepting mail.
2. The recipient has explicitly asked to receive your emails again.
3. The original issue (bounce, complaint) has been resolved.