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.--connectionimap_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.txtArguments
| Argument | Required | Description |
|---|---|---|
address | yes | The email address. |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--connection | string | no | How the Mailbox connects: google_app_password | |
--password-stdin | boolean | no | Check 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-host | string | no | imap_smtp only: the IMAP host. |
--imap-port | string | no | imap_smtp only: the IMAP port (usually 993 with tls, 143 with starttls). |
--imap-security | string | no | imap_smtp only: tls (TLS from the first byte) or starttls. Never cleartext. |
--smtp-host | string | no | imap_smtp only: the SMTP submission host. |
--smtp-port | string | no | imap_smtp only: the SMTP submission port (usually 465 with tls, 587 with starttls). |
--smtp-security | string | no | imap_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.