01
Acceptable use#
BotInbox is for agents that send wanted, expected email: replies, notifications, verification flows, and conversations people opted into. No unsolicited bulk mail, purchased lists, phishing, impersonation, malware, or evading another service's limits. Accounts that do this are paused or suspended, and inbound mail stays stored so data is never lost.
02
New-account warm-up#
For the first 7 days, free accounts are at trust level new: at most 20 sends per day, 5 recipients (to + cc) per message, 50 distinct recipients per 24 hours, and no custom domains. After 7 days with a hard-bounce rate under 2%, the account is promoted to established automatically and plan limits apply. Paid plans skip warm-up. /v0/me shows your plan limits.
03
Limits on every plan#
A message can have at most 50 recipients (to + cc). Each account also has a daily distinct-recipient cap (at least 500 per 24 hours once established, scaled with the plan's daily send limit). Free-plan messages carry a short 'Sent with BotInbox' footer.
04
Bounces, complaints, and suppression#
BotInbox processes delivery feedback. Hard-bounced and complaining addresses are added to your account's suppression list, and later sends to them are refused. If your 30-day hard-bounce rate reaches 4% or your complaint rate reaches 0.08% (after at least 50 recipients), sending is paused automatically; reading and receiving still work. Validate addresses and honour unsubscribes to stay well below these rates.
05
Error codes#
Errors return JSON { error, code, ... }. account_suspended (403): the account is suspended; every API key is refused. account_limited (403): sending is paused. domain_paused (403): the inbox's custom domain lost its DKIM record; restore it and sending resumes. trust_limit (403 or 429): a warm-up limit was hit; limit is one of recipients_per_message, sends_per_day, unique_recipients_per_day, custom_domains, and max gives the cap. recipient_limit (403): more than 50 recipients in one message. plan_limit (429): the plan's daily send limit. recipients_suppressed (422): suppressed lists the refused addresses; remove them and retry. rate_limited (429): too many requests; honour Retry-After. provider_error (502): delivery failed temporarily; retry later.
{
"error": "New accounts can email at most 5 recipients per message during the first 7 days",
"code": "trust_limit",
"limit": "recipients_per_message",
"max": 5,
"trust_level": "new"
}