Email Address Ban

An Email Address Ban prevents sending to an email address, typically due to hard bounces or spam complaints. Bans protect sender reputation and deliverability.

Schema

interface EmailAddressBan {
  id: string; // "eab_..." - Unique identifier
  account_id: string; // Owning account
  email: string; // Banned email address
  reason: string; // Why address was banned
  banned_until: string | null; // Expiration (null = permanent)
}

Properties

Property	Type	Description
`id`	`string`	KSUID with `eab_` prefix
`account_id`	`string`	Account context
`email`	`string`	Blocked email address
`reason`	`string`	Ban reason
`banned_until`	`string?`	Expiration date or null for permanent

Ban Reasons

Ban reasons are provider-specific. Common values include:

Reason	Description
`hard_bounce`	Address doesn’t exist
`soft_bounce`	Temporary delivery failure
`complaint`	Spam report received
`manual`	Manually blocked

Automatic Banning

Example

{
  "id": "eab_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "email": "invalid@example.com",
  "reason": "hard_bounce",
  "banned_until": null
}

Email - Email infrastructure
Email Message Event - Delivery events