---
title: "Add a mailbox"
method: POST
path: "/1/mail_hostings/{mail_hosting_id}/mailboxes"
tags: ["Mailbox management"]
---

# Add a mailbox

`POST /1/mail_hostings/{mail_hosting_id}/mailboxes`

Creates a new mailbox in the mail hosting.

## Path parameters

- `mail_hosting_id` integer, required

## Query parameters

- `with` string

## Request body

- object
  - `link_to_current_user` boolean
  - `mailbox_name` string, required
  - `note` string
  - `random_delivery_host` boolean, nullable
  - `signature_model_id` string, nullable
  - `target` 'current_user' | 'ksuite_user' | 'other_user' — Specifies who has access to the mailbox during its creation.<note><strong>current_user</strong>: Only the current user has access to the mailbox.</note><note><strong>ksuite_user</strong>: All users who are part of the kSuite product can access the mailbox.</note><note><strong>other_user</strong>: All invited users can have access to the mailbox.</note>

## Response `201`

Created

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 93e74a89CreatedMailbox
    - `mailbox` object, required
    - `quota` integer, required — The limit of memory associated with the mail service in Mo
    - `used` integer, required — The current number of mailboxes on the service
    - `total` integer, required — The total number of mailboxes that service can have
    - `existing_user_email` boolean

## Other responses

- `400` — Catchall not allow for starter

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)