# createEmailAddress()

Creates an [EmailAddress](https://clerk.com/docs/reference/types/email-address.md) for the specified user.

```ts
function createEmailAddress(params: CreateEmailAddressParams): Promise<EmailAddress>
```

## `CreateEmailAddressParams`

| Name         | Type    | Description                                                                                                                           |
| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| userId       | string  | The ID of the user to create the email address for.                                                                                   |
| emailAddress | string  | The email address to assign to the specified user.                                                                                    |
| primary?     | boolean | Whether or not to set the email address as the user's primary email address. Defaults to false, unless it is the first email address. |
| verified?    | boolean | Whether or not the email address is verified.                                                                                         |

## Example

> Using `clerkClient` varies based on the SDK you're using. Refer to the [overview](https://clerk.com/docs/reference/backend/overview.md) for usage details, including guidance on [how to access the `userId` and other properties](https://clerk.com/docs/reference/backend/overview.md#example-get-the-user-id-and-other-properties).

```tsx
const response = await clerkClient.emailAddresses.createEmailAddress({
  userId: 'user_123',
  emailAddress: 'testclerk123@gmail.com',
  primary: true,
  verified: true,
})
```

## Backend API (BAPI) endpoint

This method in the SDK is a wrapper around the BAPI endpoint `POST/email_addresses`. See the [BAPI reference](https://clerk.com/docs/reference/backend-api/tag/email-addresses/POST/email_addresses){{ target: '_blank' }} for more information.

---

## Sitemap

[Overview of all docs pages](https://clerk.com/docs/llms.txt)