Email Addresses

Update an email address

Changed on

Updates an email address.

patch/email_addresses/{email_address_id}

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/email_addresses/{email_address_id}
  • Auth: HTTP bearer

Path parameters

email_address_idstring required

The ID of the email address to update

Request body

verifiedboolean nullable

The email address will be marked as verified.

primaryboolean nullable

Set this email address as the primary email address for the user.

notify_primary_email_address_changedboolean nullable

If set to true and this update makes the email address the user's new primary, the previous primary email address is notified of the change. By default, no notification is sent.

Response

Success

idstring
object'email_address' required

String representing the object's type. Objects of the same type share the same value.

email_addressstring required
reservedboolean required
matches_sso_connectionboolean

Indicates whether this email address domain matches an active enterprise connection.

created_atinteger required

Unix timestamp of creation

updated_atinteger required

Unix timestamp of creation

Changes

  • 2025-11-101d47a6af3befRevision changes
    • info

      added the new optional request property

  • 2025-11-104db0b9e2d5e6Revision changes
    • info

      added the optional property ///// to the response with the status