Connect a mailbox
Auto Apply is an invite-only beta. Accounts without access receive 403 with problem code auto_apply_not_enabled.
Connects an inbox this account may read verification codes from. Mailboxes are account-level resources: connect once, then reference the mailbox id from any application’s verification retrieval call.
Optional. Connecting a mailbox is a convenience, not a requirement: email verification steps behave identically without one, and an integration that already reads the inbox itself can keep doing so and submit the code through the normal answers call. Use these endpoints only if you would rather not build and operate inbox access.
Provider imap (Gmail app passwords, custom domains, most providers) verifies the credentials synchronously — success returns status connected, a rejected login is 422 mailbox_verification_failed and nothing is stored. Provider outlook returns status pending plus an authorization_url; open it (or send it to the mailbox owner) to grant consent via Microsoft, after which the mailbox flips to connected. Outlook/Microsoft 365 requires this OAuth flow — Microsoft disabled basic-auth IMAP in April 2026 — and is read over Microsoft Graph, so the imap_* fields are neither required nor returned for it.
Credentials are encrypted at rest and never returned by any endpoint.
Authorizations
API key provided by Jobo
Body
imap connects with host + credentials; outlook starts the hosted Microsoft OAuth consent flow.
imap, outlook The mailbox address. Unique per account; lowercased.
Required for provider imap. Ports 993 and 143 only.
ssl, starttls Defaults to address.
Required for provider imap (use an app password where the provider offers them). Encrypted at rest, never returned.
Response
The mailbox. Status connected for a verified imap mailbox; status pending with authorization_url for an outlook mailbox awaiting consent.
Version of the profileless Auto Apply API contract.
2026-08-12 "2026-08-12"
imap, outlook pending = outlook mailbox awaiting consent; error = the last connectivity check failed (see last_error).
pending, connected, error, disabled Only on a pending outlook mailbox: open this URL (or send it to the mailbox owner) to grant consent via Microsoft.

