---
title: "Changes to Create"
method: POST
path: "/v1/users"
---

# Changes to Create

`POST /v1/users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 26 revisions.

- **2026-03-07** `110f26a94e5b`: 1 info
- **2026-03-06** `9cab20b8eca7`: 1 breaking
- **2026-01-09** `7dfcc14e566c`: 4 breaking
- **2025-09-24** `d1a2040cf009`: 2 info
- **2025-09-17** `8270cf3a3d4c`: 3 info
- **2025-09-17** `864b9f438ac0`: 10 breaking

## Changes

- **2026-03-07** `110f26a94e5b`: 1 info
  - endpoint added
- **2026-03-06** `9cab20b8eca7`: 1 breaking
  - api path removed without deprecation
- **2026-01-09** `7dfcc14e566c`: 4 breaking
  - the `trusted_metadata` request property type changed from `string` to `object`
  - the `untrusted_metadata` request property type changed from `string` to `object`
  - the `user/trusted_metadata` response's property type changed from `string` to `object` for status `200`
  - the `user/untrusted_metadata` response's property type changed from `string` to `object` for status `200`
- **2025-09-24** `d1a2040cf009`: 2 info
  - added the new optional request property `roles`
  - added the required property `user/roles` to the response with the `200` status
- **2025-09-17** `8270cf3a3d4c`: 3 info
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `500`
  - added the non-success response with the status `429`
- **2025-09-17** `864b9f438ac0`: 10 breaking
  - the `create_user_as_pending` request property type changed from `string` to `boolean`
  - the `status_code` response's property type changed from `string` to `integer`, and format from no format to `int32` for status `200`
  - the `user/biometric_registrations/items/verified` response's property type changed from `string` to `boolean` for status `200`
  - the `user/crypto_wallets/items/verified` response's property type changed from `string` to `boolean` for status `200`
  - the `user/emails/items/verified` response's property type changed from `string` to `boolean` for status `200`
  - the `user/is_locked` response's property type changed from `string` to `boolean` for status `200`
  - the `user/password/requires_reset` response's property type changed from `string` to `boolean` for status `200`
  - the `user/phone_numbers/items/verified` response's property type changed from `string` to `boolean` for status `200`
  - the `user/totps/items/verified` response's property type changed from `string` to `boolean` for status `200`
  - the `user/webauthn_registrations/items/verified` response's property type changed from `string` to `boolean` for status `200`

---

[Operation](https://skmtc.dev/stytch/apis/stytch-api/docs/v1/users/post.md) - [API](https://skmtc.dev/stytch/apis/stytch-api.md) - [Page](https://skmtc.dev/stytch/apis/stytch-api/changes/v1/users/post)