---
title: "Changes to Sign up with email and password"
method: POST
path: "/signup/email-password"
---

# Changes to Sign up with email and password

`POST /signup/email-password`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 20 revisions.

- **2026-09-02** `7018a6ccd5c9`: 1 breaking
- **2026-06-24** `0fc5fd589dbf`: 1 warning
- **2026-04-20** `b39086c84b43`: 1 warning, 1 info
- **2026-03-27** `fbbb4ff76b2a`: 1 info
- **2026-01-13** `7560a2934be4`: 1 breaking, 1 info
- **2025-11-11** `484d9f1a422a`: 1 warning
- **2025-10-10** `2bb5c4e40463`: 1 breaking, 2 warning, 3 info

## Changes

- **2026-09-02** `7018a6ccd5c9`: 1 breaking
  - the response property `session/user/metadata` became nullable for the status `200`
- **2026-06-24** `0fc5fd589dbf`: 1 warning
  - added the new `otp-too-many-attempts` enum value to the `error` response property for the response status `default`
- **2026-04-20** `b39086c84b43`: 1 warning, 1 info
  - added the new `user-already-exists` enum value to the `error` response property for the response status `default`
  - removed the `email-already-in-use` enum value from the `error` response property for the response status `default`
- **2026-03-27** `fbbb4ff76b2a`: 1 info
  - added the new optional request property `codeChallenge`
- **2026-01-13** `7560a2934be4`: 1 breaking, 1 info
  - the `session/user/locale` response property's maxLength was increased from `2` to `3` for the response status `200`
  - the `options/locale` request property's maxLength was increased from `2` to `3`
- **2025-11-11** `484d9f1a422a`: 1 warning
  - added the new `provider-account-already-linked` enum value to the `error` response property for the response status `default`
- **2025-10-10** `2bb5c4e40463`: 1 breaking, 2 warning, 3 info
  - the `options/locale` request property's maxLength was decreased to `2`
  - removed the request property `codeChallenge`
  - added the new `email-already-in-use` enum value to the `error` response property for the response status `default`
  - removed the `otp-too-many-attempts` enum value from the `error` response property for the response status `default`
  - removed the `provider-account-already-linked` enum value from the `error` response property for the response status `default`
  - removed the `user-already-exists` enum value from the `error` response property for the response status `default`

---

[Operation](https://skmtc.dev/nhost/apis/nhost-authentication-api/docs/signup/email-password/post.md) - [API](https://skmtc.dev/nhost/apis/nhost-authentication-api.md) - [Page](https://skmtc.dev/nhost/apis/nhost-authentication-api/changes/signup/email-password/post)