Connect mailbox
Connect an SMTP/IMAP mailbox to the workspace. Send the outgoing server credentials under “smtp” and the incoming server credentials under “imap”. Both are verified against the mail provider before anything is stored, so a bad host, port or password fails with 400 and creates nothing; the message names the failing protocol and, where the reason is recognized (wrong credentials, unreachable host, TLS mismatch, …), a short cause. On success the mailbox is returned with status “pending”: registration with the mail infrastructure finishes moments later and flips it to “active”, or to “access_lost” if it fails. Poll GET /workspaces//mailboxes/ to observe the final status. Connecting is idempotent by address: a second request for an address already mid-connect returns 409 instead of racing the first. Google and Outlook mailboxes connect through /mailboxes/oauth-link instead.
Authorizations
Path Parameters
Workspace ID
Body
Mailbox connection request
- Option 1
- Option 2
The body is of type object.
Response
Mailbox
gmail, outlook, smtp active, frozen, access_lost, deleted, inactive, pending, suspended active, pending 