---
title: "Create mailbox"
method: POST
path: "/api/mail/v1/orders/{orderId}/mailboxes"
tags: ["Mail: Mailboxes"]
---

# Create mailbox

`POST /api/mail/v1/orders/{orderId}/mailboxes`

Create a mailbox under the given mail order. The full email address is
composed from the given local part and the domain of the order.

## Path parameters

- `orderId` string, required

## Request body

- MailV1SchemaCreateMailboxRequestSchema
  - `local_part` string, required — Local part of the mailbox address (the part before the @). The domain is taken from the order. Must start and end with a letter or digit; single dots, underscores and hyphens are allowed in between.
  - `password` string, password, required — Mailbox password. Minimum 8 characters with uppercase, lowercase, number and special character.

## Response `201`

Created response

- MailV1MailboxesMailboxResource
  - `id` string — Mailbox resource ID
  - `address` string — Email address of the mailbox
  - `status` 'active' | 'suspended' — Mailbox status
  - `status_reason` string, nullable — Reason the mailbox was suspended
  - `protocols` MailV1MailboxesMailboxProtocolsResource
    - `is_imap_enabled` boolean
    - `is_pop3_enabled` boolean
    - `is_smtp_in_enabled` boolean
    - `is_smtp_out_enabled` boolean
  - `counts` MailV1MailboxesMailboxCountsResource
    - `forwarders` integer — Number of attached forwarders
    - `aliases` integer — Number of attached aliases
    - `autoreplies` integer — Number of attached auto-replies
  - `is_catchall` boolean — Whether the mailbox is the catch-all destination for its domain
  - `usage` MailV1MailboxesMailboxUsageResource — Periodically synced usage numbers (may lag behind live values)
    - `storage_used` integer — Storage used in kilobytes
    - `storage_quota` integer — Storage quota in kilobytes
    - `messages_used` integer
    - `messages_quota` integer
    - `synced_at` string, date-time, nullable — When the usage numbers were last synced; null if never synced
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthenticated response
- `404` — Error response
- `409` — Error response
- `422` — Error response
- `500` — Error response

---

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