---
title: "Manage email-only user"
method: POST
path: "/v1/users/email-only"
tags: ["Schedule recipients"]
---

# Manage email-only user

`POST /v1/users/email-only`

Create or update an [email-only user](/share/deliveries/email). An email-only user is a recipient of a delivery that isn't associated with an Omni account.

If Omni matches the provided email to an existing email-only user, the user will be updated according to the `userAttributes` in the request body.

<Tip>
  Need to include multiple email-only users? Use the [Create or update multiple email-only users](/api/schedule-recipients/bulk-manage-email-only-users) endpoint.
</Tip>

## Request body

- object
  - `email` string, email, required — The user's email address.
  - `userAttributes` object — An object defining the user's [user attributes](/administration/users/attributes). Attributes are represented as key/value pairs, where the keys map to the IDs of user attributes (the **Reference** column in the **User attributes** page) defined in Omni. When providing user attributes, note that: - `omni_user_timezone` is the only supported system attribute - **Values must match the user attribute's specified type**. For example, `number` attribute values must be numbers such as `1`, `10`, etc. - **Multi-value attributes should be provided using arrays**. For example: `["US","EU"]` or `[1, 10]` To unset attributes: - `null` values - `""` - Empty strings for string attributes - `[]` - Empty arrays for multi-value attributes

## Response `200`

Email-only user created or updated successfully.

- object
  - `email` string, email — The email address of the created or updated user.
  - `userId` string, uuid — The unique identifier of the email-only user.

## Other responses

- `400` — Bad Request. Possible error messages include: - `Invalid JSON` - `email: email is required` - `email: Invalid email address` - `The provided user attributes: "<attribute>" do not match the names of existing user attributes.` - `User Attribute <attribute> is type number, but passed-in value <value> is not a number.` - `The timezone <invalidTimezone> is not supported. Please see the connection page or [user profile page](/administration/users/your-account) for the list of valid timezones. Use e.g. "America/New_York" instead of "EST"` - `User Attribute <attribute> has multiple values enabled, but the passed-in value is not an array. If passing a single value for a user attribute with multiple values enabled, please wrap the value in an array [x].`
- `405` — Method Not Allowed - Invalid HTTP method for this endpoint
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

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