Register new account

POST 
/v1/account

Registers new IMAP account to be synced

Credentials are not verified while handling this request. The account connects afterwards, and an authentication failure surfaces as an authenticationError state rather than an error here. Use the account verification endpoint to test credentials up front.

Request

Responses

200

Returns the registered account, including the generated account ID when one was not supplied.

400

Invalid input - the path parameters, query arguments, or request payload did not pass validation

401

Authentication failed - the access token is missing, invalid, or was not accepted

403

Access denied - the access token does not grant permission for this operation (token scope, account, or IP address restriction)

404

Not found - the requested entity (account, message, mailbox, etc.) does not exist

429

Rate limit exceeded - too many requests were made with this access token

500

Internal server error - an unexpected error occurred while processing the request