---
title: "Changes to POST /api/tenants/{tenantId}/users"
method: POST
path: "/api/tenants/{tenantId}/users"
---

# Changes to POST /api/tenants/{tenantId}/users

`POST /api/tenants/{tenantId}/users`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 18 revisions.

- **2026-07-17** `34e260deaa2c` — 4 warning
- **2026-03-09** `642427b60b7a` — 76 warning
- **2025-03-12** `8f09691a3e2e` — 6 breaking, 2 warning, 8 info
- **2025-02-12** `e55062063156` — 12 warning, 46 info
- **2023-07-23** `fd1b5146be4a` — 6 breaking, 26 warning, 122 info

## Changes

- **2026-07-17** `34e260deaa2c` — 4 warning
  - removed the request property `password` (media type: application/json)
  - removed the request property `password` (media type: text/json)
  - removed the request property `password` (media type: application/*+json)
  - removed the optional property `password` from the response with the `201` status
- **2026-03-09** `642427b60b7a` — 76 warning
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/addMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/raiseMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/removeMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredMethods/items/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredProperties/items/getMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredProperties/items/setMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/entryPoint/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/declaredEvents/items/addMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/declaredEvents/items/raiseMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/declaredEvents/items/removeMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/declaredMethods/items/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/declaredProperties/items/getMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/declaredProperties/items/setMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/entryPoint/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/addMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/raiseMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredEvents/items/removeMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredMethods/items/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredProperties/items/getMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredProperties/items/setMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/entryPoint/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/declaredEvents/items/addMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/declaredEvents/items/raiseMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/declaredEvents/items/removeMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/declaredMethods/items/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/declaredProperties/items/getMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/declaredProperties/items/setMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/entryPoint/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/declaredEvents/items/addMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/declaredEvents/items/raiseMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/declaredEvents/items/removeMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/declaredMethods/items/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/declaredProperties/items/getMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/declaredProperties/items/setMethod/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/entryPoint/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/methodImplementationFlags` response property for the response status `422`
  - added the new `8192.00` enum value to the `additionalProperties/errors/items/exception/targetSite/module/assembly/definedTypes/items/declaredEvents/items/addMethod/methodImplementationFlags` response property for the response status `422`
  - …36 more
- **2025-03-12** `8f09691a3e2e` — 6 breaking, 2 warning, 8 info
  - removed the enum value `Administrator` of the request property `userType` (media type: application/json)
  - removed the enum value `Administrator` of the request property `userType` (media type: text/json)
  - removed the enum value `Administrator` of the request property `userType` (media type: application/*+json)
  - removed the enum value `Supervisor` of the request property `userType` (media type: application/json)
  - removed the enum value `Supervisor` of the request property `userType` (media type: text/json)
  - removed the enum value `Supervisor` of the request property `userType` (media type: application/*+json)
  - added the new `SystemAdministrator` enum value to the `userType` response property for the response status `201`
  - added the new `TenantAdministrator` enum value to the `userType` response property for the response status `201`
  - added the new `SystemAdministrator` enum value to the request property `userType` (media type: application/json)
  - added the new `SystemAdministrator` enum value to the request property `userType` (media type: text/json)
  - added the new `SystemAdministrator` enum value to the request property `userType` (media type: application/*+json)
  - added the new `TenantAdministrator` enum value to the request property `userType` (media type: application/json)
  - added the new `TenantAdministrator` enum value to the request property `userType` (media type: text/json)
  - added the new `TenantAdministrator` enum value to the request property `userType` (media type: application/*+json)
  - removed the `Administrator` enum value from the `userType` response property for the response status `201`
  - removed the `Supervisor` enum value from the `userType` response property for the response status `201`
- **2025-02-12** `e55062063156` — 12 warning, 46 info
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/module/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/reflectedType/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/reflectedType/customAttributes/items/constructor/module/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/reflectedType/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/reflectedType/module/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the new `32.00` enum value to the `additionalProperties/errors/items/exception/targetSite/reflectedType/typeInitializer/module/assembly/definedTypes/items/genericParameterAttributes` response property for the response status `422`
  - added the optional property `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/module/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/customAttributes/items/constructor/module/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/customAttributes/items/constructor/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/module/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/typeInitializer/module/assembly/definedTypes/items/isFunctionPointer` to the response with the `422` status
  - added the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/typeInitializer/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` to the response with the `422` status
  - response property `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/declaredFields/items/isNotSerialized` deprecated
  - response property `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/isSerializable` deprecated
  - response property `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/declaredFields/items/isNotSerialized` deprecated
  - response property `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/isSerializable` deprecated
  - …18 more
- **2023-07-23** `fd1b5146be4a` — 6 breaking, 26 warning, 122 info
  - removed the enum value `SystemAdministrator` of the request property `userType` (media type: application/json)
  - removed the enum value `SystemAdministrator` of the request property `userType` (media type: text/json)
  - removed the enum value `SystemAdministrator` of the request property `userType` (media type: application/*+json)
  - removed the enum value `TenantAdministrator` of the request property `userType` (media type: application/json)
  - removed the enum value `TenantAdministrator` of the request property `userType` (media type: text/json)
  - removed the enum value `TenantAdministrator` of the request property `userType` (media type: application/*+json)
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/customAttributes/items/constructor/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/customAttributes/items/constructor/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/declaringType/typeInitializer/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/customAttributes/items/constructor/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/customAttributes/items/constructor/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/typeInitializer/module/assembly/definedTypes/items/isFunctionPointer` from the response with the `422` status
  - removed the optional property `additionalProperties/errors/items/exception/targetSite/reflectedType/typeInitializer/module/assembly/definedTypes/items/isUnmanagedFunctionPointer` from the response with the `422` status
  - added the new `Administrator` enum value to the `userType` response property for the response status `201`
  - added the new `Supervisor` enum value to the `userType` response property for the response status `201`
  - added the new optional request property `password` (media type: application/json)
  - added the new optional request property `password` (media type: text/json)
  - added the new optional request property `password` (media type: application/*+json)
  - added the new `Administrator` enum value to the request property `userType` (media type: application/json)
  - added the new `Administrator` enum value to the request property `userType` (media type: text/json)
  - added the new `Administrator` enum value to the request property `userType` (media type: application/*+json)
  - added the new `Supervisor` enum value to the request property `userType` (media type: application/json)
  - added the new `Supervisor` enum value to the request property `userType` (media type: text/json)
  - …114 more

---

[Operation](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/docs/api/tenants/:tenantId/users/post.md) · [API](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1.md) · [Page](https://skmtc.dev/payroll-engine/apis/payroll-engine-backend-api-v1/changes/api/tenants/:tenantId/users/post)