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

# Changes to POST /v1/users

`POST /v1/users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 13 of 72 revisions.

- **2026-09-22** `b7373ed243ff`: 2 breaking, 1 warning
- **2026-01-14** `1a84c9639e0b`: 1 info
- **2024-11-07** `bf0b42ebdc02`: 1 info
- **2023-08-24** `3419337bcb8a`: 1 breaking, 1 info
- **2023-08-24** `6ddeb2c9e28d`: 1 breaking, 1 info
- **2023-08-24** `75f7a3d8a09e`: 1 breaking, 1 info
- **2023-08-22** `2b43f8cf5d91`: 2 breaking, 5 warning, 3 info
- **2023-02-08** `bab0fa58d166`: 1 info
- **2023-01-10** `dcffa935d88d`: 3 info
- **2023-01-10** `4a5e1aae32ed`: 3 breaking, 3 info
- **2022-12-29** `f35d8f51b566`: 3 breaking, 1 warning
- **2022-12-26** `bf4e86e008a9`: 1 breaking, 1 warning, 1 info
- **2022-12-26** `7ec2bb4309ef`: 1 info

## Changes

- **2026-09-22** `b7373ed243ff`: 2 breaking, 1 warning
  - added the new required request property `givenName`
  - added the new required request property `surname`
  - removed the request property `name`
- **2026-01-14** `1a84c9639e0b`: 1 info
  - added the new optional request property `strategicRoles`
- **2024-11-07** `bf0b42ebdc02`: 1 info
  - the response property `id` became required for the status `201`
- **2023-08-24** `3419337bcb8a`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2023-08-24** `6ddeb2c9e28d`: 1 breaking, 1 info
  - removed the success response with the status `201`
  - added the success response with the status `200`
- **2023-08-24** `75f7a3d8a09e`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`
- **2023-08-22** `2b43f8cf5d91`: 2 breaking, 5 warning, 3 info
  - the request property `role` became not nullable
  - the request property `role` became required
  - the `email` request property's maxLength was set to `100`
  - the `name` request property's maxLength was set to `100`
  - removed the request property `organisationAcronym`
  - removed the request property `organisationUnitAcronym`
  - removed the request property `type`
  - added `subschema #1` to the request body `oneOf` list
  - added the new `ADMIN` enum value to the request property `role`
  - added the new `ASSESSMENT` enum value to the request property `role`
- **2023-02-08** `bab0fa58d166`: 1 info
  - added the new `QUALIFYING_ACCESSOR` enum value to the request property `type`
- **2023-01-10** `dcffa935d88d`: 3 info
  - the request property `organisationAcronym` became nullable
  - the request property `organisationUnitAcronym` became nullable
  - the request property `role` became nullable
- **2023-01-10** `4a5e1aae32ed`: 3 breaking, 3 info
  - the request property `organisationAcronym` became not nullable
  - the request property `organisationUnitAcronym` became not nullable
  - the request property `role` became not nullable
  - the request property `organisationAcronym` became optional
  - the request property `organisationUnitAcronym` became optional
  - the request property `role` became optional
- **2022-12-29** `f35d8f51b566`: 3 breaking, 1 warning
  - added the new required request property `organisationAcronym`
  - added the new required request property `organisationUnitAcronym`
  - added the new required request property `role`
  - removed the request property `organisation`
- **2022-12-26** `bf4e86e008a9`: 1 breaking, 1 warning, 1 info
  - removed the enum value `INNOVATOR` of the request property `type`
  - removed the optional property `unitId` from the response with the `200` status
  - added the optional property `id` to the response with the `200` status
- **2022-12-26** `7ec2bb4309ef`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/nhs-england/apis/admin-api-nhs-innovation-service/docs/v1/users/post.md) - [API](https://skmtc.dev/nhs-england/apis/admin-api-nhs-innovation-service.md) - [Page](https://skmtc.dev/nhs-england/apis/admin-api-nhs-innovation-service/changes/v1/users/post)