Assign New Mailbox to Domain

POST

/v1/mailboxes

Create and assign a new mailbox under a domain owned by the user.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Example

{
    "domainId": "cmg9l788c0001la04ctg7t1j4",
    "username": "mary",
    "fullName": "Mary Doe"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/mailboxes' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "domainId": "cmg9l788c0001la04ctg7t1j4",
    "username": "mary",
    "fullName": "Mary Doe"
}'

Responses

🟢201

application/json

Mailbox created successfully

Bodyapplication/json

Example

{
    "id": "cmg9l78m8000bla04a6onx0ih",
    "username": "Mary",
    "fullName": "Mary",
    "status": "PENDING",
    "createdAt": "2025-10-02T15:45:32.768Z"
}

🟠400

🟠401

Retrieve Mailboxes

Get Mailbox Details