---
title: "Create mailbox"
method: POST
path: "/domains/{domain}/mailboxes"
tags: ["Mailboxes"]
---

# Create mailbox

`POST /domains/{domain}/mailboxes`

Creates a new mailbox for the specified domain with optional forwarding and webmail access

## Path parameters

- `domain` string, required

## Request body

- RestmailstackMailboxRequest — Request payload for creating and configuring a new mailbox
  - `forwardingTo` string[] — List of email addresses to forward to required: false maxItems: 10 example: ["user1@example.com","user2@example.com"]
  - `linkedUser` string — Associated user's email address required: false format: email example: john.doe@mycompany.com
  - `password` string — Password for mailbox access required: false minLength: 8 maxLength: 64 example: SecurePassword123!
  - `username` string — Username for the mailbox required: true pattern: ^[a-zA-Z0-9._%+-]+$ minLength: 3 maxLength: 64 example: john.doe
  - `webmailEnabled` boolean — Enable webmail access required: false default: false

## Response `200`

Mailbox created successfully with generated password

- RestmailstackMailboxResponse — Response containing mailbox details and status
  - `mailbox` RestmailstackMailboxRecord — Comprehensive mailbox configuration and status
    - `email` string — Email address for the mailbox required: true format: email example: user@example.com
    - `forwardingEnabled` boolean — Email forwarding status required: true default: false
    - `forwardingTo` string[] — List of forwarding email addresses required: false maxItems: 10
    - `password` string — Mailbox password (only included in specific responses) required: false minLength: 8 maxLength: 64
    - `webmailEnabled` boolean — Webmail access status required: true default: false
  - `requestId` string
  - `status` string — Status indicates the result of the operation ("success" or "error")

## Other responses

- `400` — Invalid request - Missing or invalid parameters
- `401` — Unauthorized - Missing or invalid API key
- `404` — Domain not found
- `409` — Mailbox already exists
- `500` — Internal server error

## Changes

- **2026-07-17** `73526747b270` — 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/customeros/apis/customeros-api/changes/domains/:domain/mailboxes/post.md)

---

[API](https://skmtc.dev/customeros/apis/customeros-api.md) · [All operations](https://skmtc.dev/customeros/apis/customeros-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customeros/customeros-api/revisions/73526747b270/schema)