Email Address Ban (Types) | Accountmaker API Documentation

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