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

# Changes to Create a user

`POST /users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 11 of 75 revisions.

- **2026-10-15** `00f3e37c4d30`: 2 info
- **2023-09-27** `7400aae8fd5c`: 1 breaking, 1 info
- **2023-09-21** `ea23baac3b30`: 1 breaking, 1 info
- **2023-09-20** `8ff141936638`: 1 breaking, 1 info
- **2023-08-15** `44fbe9f14200`: 1 breaking, 5 info
- **2023-08-04** `9f4851dfc828`: 1 breaking, 5 warning
- **2023-03-06** `7de0ab0187e0`: 1 info
- **2023-03-06** `3d206bb302b3`: 1 info
- **2023-02-28** `04020a819bc0`: 1 info
- **2022-09-21** `bdd22064f19e`: 1 info
- **2022-09-20** `eea125543546`: 1 info

## Changes

- **2026-10-15** `00f3e37c4d30`: 2 info
  - added the new optional request property `userGroups`
  - added the optional property `data/userGroups` to the response with the `200` status
- **2023-09-27** `7400aae8fd5c`: 1 breaking, 1 info
  - the response property `data/roles` became optional for the status `200`
  - the request property `roles` became optional
- **2023-09-21** `ea23baac3b30`: 1 breaking, 1 info
  - the request property `roles` became required
  - the response property `data/roles` became required for the status `200`
- **2023-09-20** `8ff141936638`: 1 breaking, 1 info
  - the response property `data/roles` became optional for the status `200`
  - the request property `roles` became optional
- **2023-08-15** `44fbe9f14200`: 1 breaking, 5 info
  - added the new required request property `roles`
  - added the new optional request property `admin`
  - added the new optional request property `builder`
  - added the optional property `data/admin` to the response with the `200` status
  - added the optional property `data/builder` to the response with the `200` status
  - added the required property `data/roles` to the response with the `200` status
- **2023-08-04** `9f4851dfc828`: 1 breaking, 5 warning
  - removed the required property `data/roles` from the response with the `200` status
  - removed the request property `admin`
  - removed the request property `builder`
  - removed the request property `roles`
  - removed the optional property `data/admin` from the response with the `200` status
  - removed the optional property `data/builder` from the response with the `200` status
- **2023-03-06** `7de0ab0187e0`: 1 info
  - api operation id `create` removed and replaced with `userCreate`
- **2023-03-06** `3d206bb302b3`: 1 info
  - api operation id `userCreate` removed and replaced with `create`
- **2023-02-28** `04020a819bc0`: 1 info
  - api operation id `create` removed and replaced with `userCreate`
- **2022-09-21** `bdd22064f19e`: 1 info
  - api operation id `createUser` removed and replaced with `create`
- **2022-09-20** `eea125543546`: 1 info
  - api operation id `createUser` was added

---

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