---
title: "Changes to Create an email address"
method: POST
path: "/email_addresses"
---

# Changes to Create an email address

`POST /email_addresses`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 49 revisions.

- **2026-07-30** (2025-11-10) `1d47a6af3bef`: 1 info
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 1 info
- **2026-05-28** (2025-11-10) `e3f2b3a1c567`: 1 breaking, 1 info
- **2026-02-21** (2025-11-10) `6b6bf4e8c298`: 1 info

## Changes

- **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`: 1 info
  - 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 breaking, 1 info
  - added `#/components/schemas/verification_scim` to the `verification` response property `oneOf` list for the response status `200`
  - added `verification_scim` discriminator mapping keys to the `verification` response property for the response status `200`
- **2026-02-21** (2025-11-10) `6b6bf4e8c298`: 1 info
  - added the non-success response with the status `409`

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/email_addresses/post.md) - [API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [Page](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/email_addresses/post)