curviate mailbox connect

Connect 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.

Usage

curviate mailbox connect <address> [flags]

Requires:

  • --connection: google_app_password, google_sign_in, microsoft_sign_in or imap_smtp.
  • --connection imap_smtp: --imap-host, --imap-port, --imap-security, --smtp-host, --smtp-port, --smtp-security.

Examples

curviate mailbox connect anna@acme.example --connection google_sign_in
curviate mailbox connect anna@gmail.com --connection google_app_password --password-stdin < app-password.txt
curviate mailbox connect anna@acme.example --connection imap_smtp --imap-host imap.acme.example --imap-port 993 --imap-security tls --smtp-host smtp.acme.example --smtp-port 465 --smtp-security tls --password-stdin < mail-password.txt

Arguments

ArgumentRequiredDescription
addressyesThe email address.

Flags

FlagTypeRequiredDescription
--connectionstringnoHow the Mailbox connects: google_app_password | google_sign_in | microsoft_sign_in | imap_smtp.
--password-stdinbooleannoCheck and keep a password the person gave you: one line from stdin, never echoed, sent only in the request body and never printed. No flag takes the password as a value: it would show in ps and in shell history. Default: false.
--imap-hoststringnoimap_smtp only: the IMAP host.
--imap-portstringnoimap_smtp only: the IMAP port (usually 993 with tls, 143 with starttls).
--imap-securitystringnoimap_smtp only: tls (TLS from the first byte) or starttls. Never cleartext.
--smtp-hoststringnoimap_smtp only: the SMTP submission host.
--smtp-portstringnoimap_smtp only: the SMTP submission port (usually 465 with tls, 587 with starttls).
--smtp-securitystringnoimap_smtp only: tls or starttls. Never cleartext.

Also accepts these global flags: --api-key, --profile, --account, --team, --base-url, --timeout, --json, --fields, --preview, --verbose, --beta.

Exit codes: the exit code table. More commands: Mailbox.