Mailbox

Mailboxes: your Team's own email Mailboxes, the addresses Campaigns send from. List, read, set who a Mailbox sends for, its daily cap and signature, pause, resume, remove, find the settings for an address (discover), connect and reconnect (a password goes in only through --password-stdin). Every role reads; Owners and Managers change any Mailbox, a Member the ones they connected. A Mailbox takes no seat and is never billed.

Before you start: an API key and a connected LinkedIn account, see the Quickstart.

Commands

CommandDescription
curviate mailbox listList your Team's Mailboxes, newest first: state, Sends for, daily cap, sent today, bounces over 7 days, paused until. Every role reads. A Mailbox in ramping works up to its cap; the steps are never shown. No secret is ever in the answer.
curviate mailbox getOne Mailbox: address, state, Sends for and its suggestion, daily cap (and cap_lowered_to when a spam reading lowered it), sent today, bounces over 7 days, signature, which Accounts and Campaigns used it. Every role reads.
curviate mailbox updateChange one Mailbox: who it sends for (--sends-for an Account id, or shared), its daily cap (--daily-cap, 1 to 50, one cap across every Campaign and Account, a hard maximum for every caller) and its signature (--signature-file, plain text, up to 2,000 characters, available as {{mailbox.signature}}; nothing adds it to an email by itself). Flags you leave out stay as they are. A Mailbox linked to no Account sends nothing. Owners and Managers change any Mailbox; a Member only the ones they connected.
curviate mailbox pauseStop a Mailbox sending until you resume it. Emails due from it wait; nothing is sent from it meanwhile.
curviate mailbox resumeLet a paused Mailbox send again. A Mailbox that is not paused, or one paused by bounces or by its provider with no date, is refused with MAILBOX_STATE_CONFLICT and stays as it was.
curviate mailbox removeRemove a Mailbox and delete its stored credentials in one step. Changes no seat count and makes no billing call. Connect it again to use the address afterwards.
curviate mailbox discoverFind the IMAP and SMTP settings for an email address, to show the person and confirm before connecting. An address on Google or Microsoft answers with its connection. confirm_required marks settings that arrived unencrypted. Takes no password and the answer holds none.
curviate mailbox connectConnect a new Mailbox: creates a Connect request and prints its link for the person, who finishes in their Curviate dashboard. --connection google_sign_in (a Google Workspace whose administrator trusts Curviate) and microsoft_sign_in print the sign-in link and, where the provider needs one, the administrator link. google_app_password and imap_smtp can also take the password from you: pipe it to --password-stdin, Curviate checks it before answering, and the Mailbox is connected in this one call. imap_smtp needs the six server flags (the settings from curviate mailbox discover, as the person confirmed them). One API call.
curviate mailbox reconnectReconnect a Mailbox of your Team (state reconnect_needed, or any other): creates a Connect request and prints its link for the person. With --password-stdin on a google_app_password or imap_smtp Mailbox, the new password is checked and replaces the old one in this one call. On a google_sign_in Mailbox, --password-stdin adds an app password beside the sign-in, for warm-up; sending and reply checks stay on the sign-in. A microsoft_sign_in Mailbox takes no password. One API call.

Exit codes: the exit code table.