Update safety rules
BillionSend extension: any subset of the rules, merged over the stored ones. Needs the owner, admin or developer role, or a full access team key; inbox-scoped keys and MCP can’t change them.
/inboxes/{inbox_id}/safetyAuthorizationToken Bearer · headerobrigatórioA BillionSend API key (bs_…).
inbox_idstringobrigatórioThe inbox ID or its email address, such as support@example.com
application/jsonaccept_fromstringWho may write in: anyone; verified (DMARC-aligned senders, known threads, the allowlist); allowlist only. Mail that fails is quarantined.
anyoneverifiedallowlistallowliststring[]"local@domain" (exact) or "*@domain" (the domain and its subdomains). On the shared domain it only lets mail in
owner_addressesstring[]Owners besides the team members' login addresses; ignored on the shared domain
screeningbooleanScore external mail for prompt injection (agent inboxes only)
extract_codesbooleanExpose extracted codes and sign-in links
send_policystringWhat the inbox may send without a person's approval. On the shared domain "allowlist" answers 422, and so does "open" unless the instance lets the team start conversations there (paid plans only)
reply_onlyallowlistopenrequire_approvalbooleanEvery send waits for a person
private_codesbooleanReceived codes and sign-in links can't be sent on to anyone but owners
send_capinteger | nullUnattended recipients per UTC day; null: no cap. 1-50 on the shared domain
forward_tostring[]Forward every delivered message to these team member or owner addresses; team members only on the shared domain
Safety rules
objectstringobrigatórioinbox_safetyinbox_idstring<uuid>obrigatórioaccept_fromstringobrigatórioWho may write in: anyone; verified (DMARC-aligned senders, known threads, the allowlist); allowlist only. Mail that fails is quarantined.
anyoneverifiedallowlistallowliststring[]obrigatório"local@domain" (exact) or "*@domain" (the domain and its subdomains). On the shared domain it only lets mail in
owner_addressesstring[]obrigatórioOwners besides the team members' login addresses; ignored on the shared domain
screeningbooleanobrigatórioScore external mail for prompt injection (agent inboxes only)
extract_codesbooleanobrigatórioExpose extracted codes and sign-in links
send_policystringobrigatórioWhat the inbox may send without a person's approval. On the shared domain "allowlist" answers 422, and so does "open" unless the instance lets the team start conversations there (paid plans only)
reply_onlyallowlistopenrequire_approvalbooleanobrigatórioEvery send waits for a person
private_codesbooleanobrigatórioReceived codes and sign-in links can't be sent on to anyone but owners
send_capinteger | nullobrigatórioUnattended recipients per UTC day; null: no cap. 1-50 on the shared domain
forward_tostring[]obrigatórioForward every delivered message to these team member or owner addresses; team members only on the shared domain
Missing, malformed, unknown or revoked API key
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioRestricted API key or role
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioNot found
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioValidation error
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatórioOver the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório