Skip to main content
POST
cURL

Authorizations

X-Api-Key
string
header
required

API key provided by Jobo

Body

application/json
provider
enum<string>
required

imap connects with host + credentials; outlook starts the hosted Microsoft OAuth consent flow.

Available options:
imap,
outlook
address
string<email>
required

The mailbox address. Unique per account; lowercased.

imap_host
string | null

Required for provider imap. Ports 993 and 143 only.

imap_port
integer | null
default:993
imap_security
enum<string> | null
default:ssl
Available options:
ssl,
starttls
username
string | null

Defaults to address.

password
string | null

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.

api_version
enum<string>
required

Version of the profileless Auto Apply API contract.

Available options:
2026-08-12
Example:

"2026-08-12"

id
string<uuid>
required
provider
enum<string>
required
Available options:
imap,
outlook
address
string<email>
required
status
enum<string>
required

pending = outlook mailbox awaiting consent; error = the last connectivity check failed (see last_error).

Available options:
pending,
connected,
error,
disabled
created_at
string<date-time>
required
updated_at
string<date-time>
required
imap_host
string | null
imap_port
integer | null
imap_security
string | null
username
string | null
authorization_url
string<uri> | null

Only on a pending outlook mailbox: open this URL (or send it to the mailbox owner) to grant consent via Microsoft.

last_error
string | null
connected_at
string<date-time> | null
last_checked_at
string<date-time> | null