---
title: "Add alternate emails"
method: POST
path: "/users/{userId}/alternateemails"
tags: ["alternateEmailAddress"]
---

# Add alternate emails

`POST /users/{userId}/alternateemails`

Adds one or more alternate email addresses for the specified user.

> **Who can use this operation?**
> 
> - **Plans:** Only Enterprise plans with this feature activated by Support can use this method. If you want to activate this feature, please contact Support.
> - **Permissions:** System Admin

## Request body

- union
  - AddAlternateEmail
    - `email` string — User's alternate email address.
  - AddAlternateEmail[]
    - `email` string — User's alternate email address.

## Response `200`

Result object containing an array of the newly created [AlternateEmail
objects](/api/smartsheet/openapi/alternateemailaddress/alternateemail).

- object
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation
  - `data` AlternateEmail[] — Updated User Properties
    - `id` number — AlternateEmail ID.
    - `confirmed` boolean — Indicates whether the alternate email address has been confirmed.
    - `email` string — User's alternate email address.

## Other responses

- `default` — If a single email address is specified in the request and an error occurs, the response contains an Error object. If multiple email addresses are specified in the request and an error occurs, the Error object returned contains a detail attribute set to an array of objects, each object in the array having the following attributes: * email: Problematic email address specified in the request * errorCode: Smartsheet error code * message: Message that describes the problem with the specified email address For example: ```javascript { "errorCode": 1160, "message": "Invalid bulk request. See detail for more information." "detail": [ { "email": "altEmail1@smartsheet.com", "errorCode": 1157, "message": "This address is already associated with another Smartsheet account, so it cannot be added as an alternate address for this account." } ] } ```

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)