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

# Changes to Create user

`POST /users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 28 revisions.

- **2026-07-23** `c4c6162ab77f`: 24 breaking, 8 warning, 19 info
- **2026-05-15** `180fda38d099`: 2 breaking, 3 warning
- **2026-05-06** `9025167b1683`: 12 info

## Changes

- **2026-07-23** `c4c6162ab77f`: 24 breaking, 8 warning, 19 info
  - request property `country_code` was restricted to a list of enum values
  - request property `display_name` was restricted to a list of enum values
  - request property `password` was restricted to a list of enum values
  - request property `primary_email` was restricted to a list of enum values
  - request property `profile_image_url` was restricted to a list of enum values
  - request property `restricted_by_admin_private_details` was restricted to a list of enum values
  - request property `restricted_by_admin_reason` was restricted to a list of enum values
  - request property `totp_secret_base64` was restricted to a list of enum values
  - the response property `client_metadata` became nullable for the status `201`
  - the response property `client_read_only_metadata` became nullable for the status `201`
  - the response property `country_code` became nullable for the status `201`
  - the response property `display_name` became nullable for the status `201`
  - the response property `primary_email` became nullable for the status `201`
  - the response property `profile_image_url` became nullable for the status `201`
  - the response property `restricted_by_admin_private_details` became nullable for the status `201`
  - the response property `restricted_by_admin_reason` became nullable for the status `201`
  - the response property `restricted_reason` became nullable for the status `201`
  - the response property `selected_team` became nullable for the status `201`
  - the response property `selected_team/client_metadata` became nullable for the status `201`
  - the response property `selected_team/client_read_only_metadata` became nullable for the status `201`
  - the response property `selected_team/profile_image_url` became nullable for the status `201`
  - the response property `selected_team/server_metadata` became nullable for the status `201`
  - the response property `selected_team_id` became nullable for the status `201`
  - the response property `server_metadata` became nullable for the status `201`
  - added the new `undefined` enum value to the `country_code` response property for the response status `201`
  - added the new `undefined` enum value to the `display_name` response property for the response status `201`
  - added the new `undefined` enum value to the `primary_email` response property for the response status `201`
  - added the new `undefined` enum value to the `profile_image_url` response property for the response status `201`
  - added the new `undefined` enum value to the `restricted_by_admin_private_details` response property for the response status `201`
  - added the new `undefined` enum value to the `restricted_by_admin_reason` response property for the response status `201`
  - added the new `undefined` enum value to the `selected_team/profile_image_url` response property for the response status `201`
  - added the new `undefined` enum value to the `selected_team_id` response property for the response status `201`
  - the request property `client_metadata` became nullable
  - the request property `client_read_only_metadata` became nullable
  - the request property `country_code` became nullable
  - the request property `display_name` became nullable
  - the request property `password` became nullable
  - the request property `primary_email` became nullable
  - the request property `profile_image_url` became nullable
  - the request property `restricted_by_admin_private_details` became nullable
  - …11 more
- **2026-05-15** `180fda38d099`: 2 breaking, 3 warning
  - the `risk_scores/sign_up/bot` request property type changed from `number` to `integer`
  - the `risk_scores/sign_up/free_trial_abuse` request property type changed from `number` to `integer`
  - added the new `anonymous` enum value to the `restricted_reason/type` response property for the response status `201`
  - added the new `email_not_verified` enum value to the `restricted_reason/type` response property for the response status `201`
  - added the new `restricted_by_administrator` enum value to the `restricted_reason/type` response property for the response status `201`
- **2026-05-06** `9025167b1683`: 12 info
  - added the new optional request property `country_code`
  - added the new optional request property `restricted_by_admin`
  - added the new optional request property `restricted_by_admin_private_details`
  - added the new optional request property `restricted_by_admin_reason`
  - added the new optional request property `risk_scores`
  - added the optional property `country_code` to the response with the `201` status
  - added the optional property `restricted_by_admin_private_details` to the response with the `201` status
  - added the optional property `restricted_by_admin_reason` to the response with the `201` status
  - added the optional property `restricted_reason` to the response with the `201` status
  - added the required property `is_restricted` to the response with the `201` status
  - added the required property `restricted_by_admin` to the response with the `201` status
  - added the required property `risk_scores` to the response with the `201` status

---

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