# REST Resource: users.aliases

## Resource: UserAlias

The Directory API manages aliases, which are alternative email addresses.

> [!NOTE]
> **Note:** Aliases are not supported for guest users.

| JSON representation |
|---|
| ``` { "id": string, "primaryEmail": string, "alias": string, "kind": string, "etag": string } ``` |

| Fields ||
|---|---|
| `id` | `string` The unique ID for the user. |
| `primaryEmail` | `string` The user's primary email address. |
| `alias` | `string` The alias email address. |
| `kind` | `string` The type of the API resource. For Alias resources, the value is `admin#directory#alias`. |
| `etag` | `string` ETag of the resource. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/users.aliases/delete` | Removes an alias. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/users.aliases/insert` | Adds an alias. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/users.aliases/list` | Lists all aliases for a user. |
| ### `https://developers.google.com/workspace/admin/directory/reference/rest/v1/users.aliases/watch` | Watches for changes in users list. |