Buy a mailbox

POST 
/mail/mailboxes

Buys a mailbox for one calendar month, charged to the integration balance at the catalog price. account_id determines api_user_id; domain_id must be active and available to that account. The address is local_part@domain. Use the plan price directly: no purchase quote is required. The paid period begins when provisioning completes. HTTP 202 means the order was accepted; read GET /orders/{order_id} until completed and use mailbox_id to retrieve the mailbox. auto_renew defaults to false.

Request

Responses

202

Successful response

401

Missing or invalid key, mismatched ID, or inactive integration

403

Access denied.

404

Resource not found in this integration.

409

Resource state, payment, price or idempotency conflict. See the mail guide for error codes.

422

Invalid request fields or unsupported parameters

500

Unexpected server error

503

Mail service or usage data temporarily unavailable.