---
title: "Changes to Replace a user's email address"
method: PUT
path: "/users/{user_id}/email_address"
---

# Changes to Replace a user's email address

`PUT /users/{user_id}/email_address`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 49 revisions.

- **2026-08-03** (2025-11-10) `cb72fc5ca88d`: 1 info
- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 1 info
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 2 info
- **2026-05-28** (2025-11-10) `e3f2b3a1c567`: 1 info

## Changes

- **2026-08-03** (2025-11-10) `cb72fc5ca88d`: 1 info
  - added the new `unverified` enum value to the request property `identification_status`
- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 1 info
  - added the new optional request property `notify_primary_email_address_changed`
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 2 info
  - added the new optional request property `identification_status`
  - added the optional property `verification/oneOf[#/components/schemas/verification_otp]/channel` to the response with the `200` status
- **2026-05-28** (2025-11-10) `e3f2b3a1c567`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/users/:user_id/email_address/put.md) - [API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [Page](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/users/:user_id/email_address/put)