---
title: "Create mailbox aliases"
method: POST
path: "/2/mail_hostings/{service_mail}/mailboxes/{mailbox}/aliases"
tags: ["Mailboxes > Aliases"]
---

# Create mailbox aliases

`POST /2/mail_hostings/{service_mail}/mailboxes/{mailbox}/aliases`

## Request

- Base URL: `https://api.infomaniak.com`
- URL: `https://api.infomaniak.com/2/mail_hostings/{service_mail}/mailboxes/{mailbox}/aliases`
- Auth: HTTP bearer

Create an alias for the mailbox specified

## Path parameters

- `service_mail` integer, required
- `mailbox` string, required

## Request body

- object
  - `alias` string
  - `aliases` string[]: List of aliases

## Response `201`

Created

- object
  - `result` 'success' | 'error' | 'asynchronous', required: Result of the HTTP request
  - `data` boolean

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-10-28** `876c540ed2ae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/changes/2/mail_hostings/:service_mail/mailboxes/:mailbox/aliases/post.md)

---

[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.dev/infomaniak/apis/api-reference-developer-tools/revisions/96ca7c8a0545?raw)