Connect a mailbox
Connects any mailbox with SMTP and IMAP: both sign-ins are checked before it is saved, and replies come back over IMAP. Connecting a mailbox the organization has signs it in again and keeps its settings.
A sign-in the server refuses answers 422 smtp_login_rejected; a host that does not resolve, smtp_host_not_found; a domain whose mail Microsoft hosts, which takes no password sign-in, microsoft_oauth_required. Checking can take a minute for a slow server: allow two minutes.
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]+$Body
Response
The mailbox, connected.
A mailbox (channel email) or a LinkedIn seat (channel linkedin). A field without a value is absent.