---
title: "Add a mailbox alias"
method: POST
path: "/api/emails/{address}/aliases"
tags: ["Email"]
---

# Add a mailbox alias

`POST /api/emails/{address}/aliases`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/emails/{address}/aliases`
- Auth: HTTP bearer

Add an alias address that delivers into this mailbox, without using a mailbox slot. The alias must be on the same domain as the mailbox. Provide a bare slug ("sales") or a full address ("sales@mysite.com").

## Path parameters

- `address` string, required

## Request body

- object
  - `alias` string, required: Alias address - a bare slug or full slug@domain on the same domain

## Response `201`

Alias created

- object
  - `address` string
  - `mailbox` string
  - `created_at` string, date-time
  - `hint` string

## Other responses

- `409`: Address is already a mailbox or an existing alias

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)