Create Clerk email address

Create a new email address for a Clerk user.

← All Clerk endpoints · Capability overview

POST/v1/clerk/email-addresses

https://api.vee3.io/v1/clerk/email-addresses

10 tokens

Create a new email address for a Clerk user.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

clerk.create_email_address

Parameters5 fields

clerk_instance_idstringOptional

Clerk instance id (ins_...) from clerk.get_connected_accounts. Omit to use the default connected account.

user_idstringRequired

Clerk user id (user_...) to retrieve or modify.

email_addressstringRequired

Email address to create for the user.

verifiedbooleanOptional

When true, the email address is created as verified.

primarybooleanOptional

When true, set this email as the user's primary email address.

Response9 fields

email_addressobject

8 fields

Created Clerk email address summary.

idstring

Clerk email address id (idn_...).

user_idstring

Clerk user id (user_...) that owns this email address.

email_addressstring

Email address value.

verification_statusstring

Verification status (e.g. verified, unverified, failed).

verifiedboolean

Whether the email address is verified.

primaryboolean

Whether this is the user's primary email address.

created_atinteger

Unix timestamp in milliseconds when the email address was created.

updated_atinteger

Unix timestamp in milliseconds when the email address was last updated.

HTTP errors: clerk_connection_required, clerk_connection_not_found, clerk_connection_invalid, validation_error, unauthorized, payment_required

Example request

Python

import requests

url = "https://api.vee3.io/v1/clerk/email-addresses"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}
payload = {
    "user_id": "user_2abc123",
    "email_address": "ada@example.com"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Email address created for a Clerk user.

created_email_address.json

{
  "email_address": {
    "id": "idn_2abc123",
    "user_id": "user_2abc123",
    "email_address": "ada@example.com",
    "verification_status": "unverified",
    "verified": false,
    "primary": false,
    "created_at": 1710000000000,
    "updated_at": 1710000000000
  }
}