Mailboxes

Create Mailbox

POST /users/

Create a new email account (mailbox) under an existing domain.

Request Body

Field	Type	Required	Description
domain_name	string	Yes	Parent domain (must exist and belong to your partner)
email	string	Yes	Full email address (e.g. [email protected])
password	string	Yes	Password for IMAP/SMTP login. Securely hashed by EmBoux.

Example

curl -X POST https://api.emboux.com/users/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_name": "mycompany.com",
    "email": "[email protected]",
    "password": "secure-pass-123"
  }'

Response 201 Created

{
  "id": 1,
  "domain_id": 1,
  "email": "[email protected]",
  "created_at": "2025-01-15T10:31:00"
}

Errors

Status	Detail
400	Email already exists
403	Mailbox quota exceeded for this domain
404	Domain not found

---

List Mailboxes

GET /users/?domain_id={id}

Query Parameters

Parameter	Type	Required	Description
domain_id	integer	No	Filter by domain. Omit to list all.

Example

curl "https://api.emboux.com/users/?domain_id=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 200 OK

[
  {
    "id": 1,
    "domain_id": 1,
    "email": "[email protected]",
    "created_at": "2025-01-15T10:31:00"
  }
]

---

Update Password

PUT /users/{email}

Request Body

Field	Type	Required	Description
password	string	Yes	New password

Example

curl -X PUT https://api.emboux.com/users/[email protected] \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"password": "new-secure-pass"}'

Response 200 OK

{"message": "Contraseña actualizada correctamente"}

---

Delete Mailbox

DELETE /users/{email}

Example

curl -X DELETE https://api.emboux.com/users/[email protected] \
  -H "Authorization: Bearer YOUR_API_KEY"

Response 204 No Content