---
title: "Create email alias"
method: POST
path: "/users/{user_id}/email_aliases"
tags: ["Email aliases"]
---

# Create email alias

`POST /users/{user_id}/email_aliases`

Adds a new email alias to a user account..

## Path parameters

- `user_id` string, required

## Request body

- object
  - `email` string, required — The email address to add to the account as an alias. Note: The domain of the email alias needs to be registered to your enterprise. See the [domain verification guide]( https://support.box.com/hc/en-us/articles/4408619650579-Domain-Verification ) for steps to add a new domain.

## Response `201`

Returns the newly created email alias object.

- EmailAlias — An email alias for a user.
  - `id` string — The unique identifier for this object.
  - `type` 'email_alias' — The value will always be `email_alias`.
  - `email` string — The email address.
  - `is_confirmed` boolean — Whether the email address has been confirmed.

## Other responses

- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)