Connect mailboxes in bulk
Connects 1 to 250 mailboxes in the background, each as POST /v1/accounts/email takes one. It answers 202 at once with the mailboxes it left out before any sign-in (skipped, by their place in mailboxes). Follow it with GET /v1/accounts/email/bulk/status, then list the mailboxes with GET /v1/accounts?channel=email: one whose sign-in failed is not there.
One import runs at a time: another while it runs answers 409 mailbox_import_in_progress. Imports have their own limit, 5 a minute and 20 a day.
Price: $1 a mailbox for each 30 days it stays connected, charged from your balance once it connects and then every 30 days. Your balance must cover the first 30 days of each new account when you call, or the call answers 402 insufficient_balance and connects nothing. An account whose first 30 days your balance no longer covers once it connects (another call spent it first) is disconnected at the next fee run, usually within 15 minutes, instead of charged. A later fee your balance cannot cover is tried again each day; still unpaid after 3 days, the account is disconnected. The call itself is free. Scope: connections, with a key that can write.
Authorizations
Headers
Names this operation, so a retry with the same key and body gets the first success again, marked Idempotent-Replayed, instead of running or charging twice. A mailbox's password is not compared: the same mailbox sent again with another password is the same call, and gets the first answer. Kept 24 hours for your organization and this route. A refusal (4xx) frees the key at once, so a corrected retry runs. After a server error (5xx), which may still take effect, the key stays held for 5 minutes from the call's start, and a retry in that time answers 409 idempotency_in_progress; after that, a send or import that may already have gone out answers 409 idempotency_outcome_unknown instead of running again. 1 to 255 visible ASCII characters, such as a UUID.
1 - 255^[\x21-\x7E]+$