---
title: "Create mailbox"
method: POST
path: "/api/v1/add/mailbox"
tags: ["Mailboxes"]
---

# Create mailbox

`POST /api/v1/add/mailbox`

You may create your own mailbox using this action. It takes a JSON object containing a domain informations.

## Request body

- object
  - `active` boolean — is mailbox active or not
  - `domain` string — domain name
  - `local_part` string — left part of email address
  - `name` string — Full name of the mailbox user
  - `authsource` 'mailcow' | 'ldap' | 'keycloak' | 'generic-oidc' — Specifies the authentication source for the mailbox.
  - `password2` string — mailbox password for confirmation
  - `password` string — mailbox password when using `mailcow` as the authentication source.
  - `quota` number — mailbox quota
  - `force_pw_update` boolean — forces the user to update its password on first login
  - `force_tfa` boolean — force 2FA enrollment at login
  - `tls_enforce_in` boolean — force inbound email tls encryption
  - `tls_enforce_out` boolean — force oubound tmail tls encryption

## Response `200`

OK

- object
  - `log` unknown[] — contains request object
    - unknown
  - `msg` unknown[]
    - unknown
  - `type` 'success' | 'danger' | 'error'

## Other responses

- `401` — Unauthorized

## Changes

- **2026-06-07** `50e1d81e874c` — 1 info
  - added the new optional request property `force_tfa`
- **2025-03-14** `98a6931f6325` — 1 info
  - added the new optional request property `authsource`
- **2021-04-04** `10480acad415` — 1 warning, 1 info
  - removed the request property `pasword`
  - added the new optional request property `password`
- **2020-08-25** `2888244f207a` — 3 info
  - added the new optional request property `force_pw_update`
  - added the new optional request property `tls_enforce_in`
  - added the new optional request property `tls_enforce_out`
- **2020-06-07** `47523aca063a` — 6 warning, 1 info
  - removed the request property `authsource`
  - removed the request property `force_pw_update`
  - removed the request property `force_tfa`
  - removed the request property `password`
  - …3 more

[Change history](https://skmtc.dev/mailcow/apis/mailcow-api/changes/api/v1/add/mailbox/post.md)

---

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