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

# Changes to POST /v1/users

`POST /v1/users`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 50 revisions.

- **2026-01-08** `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

## Changes

- **2026-01-08** `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`

---

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