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

# Changes to POST /v3/users

`POST /v3/users`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 28 revisions.

- **2026-10-23** `2c3293310f1f`: 1 info
- **2026-10-09** `4204f8e9b766`: 1 info
- **2026-09-08** `da40cb411786`: 1 info
- **2026-07-13** `ceedd6dd3446`: 1 breaking, 3 info
- **2026-05-08** `2fe1b751be79`: 2 info
- **2026-04-19** `a88d0ed986cf`: 5 breaking, 134 warning, 17 info
- **2026-01-16** `e856eda71f64`: 2 breaking, 4 info
- **2025-11-20** `14ad12ae7053`: 2 breaking, 2 info

## Changes

- **2026-10-23** `2c3293310f1f`: 1 info
  - added the new optional request property `edit_lock_period`
- **2026-10-09** `4204f8e9b766`: 1 info
  - added the optional property `data/edit_lock_period` to the response with the `200` status
- **2026-09-08** `da40cb411786`: 1 info
  - added the new `America/Ciudad_Juarez` enum value to the request property `timezone`
- **2026-07-13** `ceedd6dd3446`: 1 breaking, 3 info
  - the `errors/items/error/anyOf[subschema #19: Boss cannot be archived error -> subschema #20: Boss cannot be archived error]/details` response's property type changed from `null` to `object` for status `422`
  - added `#/components/schemas/ExitDateMustBeLastDayOfMonthForMonthlyTargetHoursError` to the `errors/items/error` response property `anyOf` list for the response status `422`
  - added the required property `errors/items/error/anyOf[subschema #19: Boss cannot be archived error -> subschema #20: Boss cannot be archived error]/details/teams` to the response with the `422` status
  - added the required property `errors/items/error/anyOf[subschema #19: Boss cannot be archived error -> subschema #20: Boss cannot be archived error]/details/users` to the response with the `422` status
- **2026-05-08** `2fe1b751be79`: 2 info
  - added the optional property `data/exit_date` to the response with the `200` status
  - added `#/components/schemas/ExitDateRequiresActiveUserError` to the `errors/items/error` response property `anyOf` list for the response status `422`
- **2026-04-19** `a88d0ed986cf`: 5 breaking, 134 warning, 17 info
  - removed the enum value `0.00` of the request property `wage_type`
  - the response property `data/edit_lock` became nullable for the status `200`
  - added `#/components/schemas/WorkTimeEditLockDay` to the `data/work_time_edit_lock_days` response property `oneOf` list for the response status `200`
  - the `data/edit_lock` response's property type changed from no type to `string, null` for status `200`
  - removed the required property `errors/items/error/anyOf[subschema #39: Forbidden value error -> subschema #21: Forbidden value error]/details/allowedValues` from the response with the `422` status
  - removed the request property `weekend_friday`
  - added the new `BossCannotBeArchived` enum value to the `errors/items/error/anyOf[subschema #26: Boss cannot be archived error -> subschema #18: Boss cannot be archived error]/type` response property for the response status `422`
  - added the new `EmailNotAvailable` enum value to the `errors/items/error/anyOf[subschema #9: Email not available error -> subschema #8: Email not available error]/type` response property for the response status `422`
  - added the new `Forbidden` enum value to the `errors/items/error/anyOf[subschema #24: Forbidden error -> subschema #17: Forbidden error]/type` response property for the response status `422`
  - added the new `ForbiddenValue` enum value to the `errors/items/error/anyOf[subschema #39: Forbidden value error -> subschema #21: Forbidden value error]/type` response property for the response status `422`
  - added the new `HasToBeInactive` enum value to the `errors/items/error/anyOf[subschema #16: Has to be inactive error -> subschema #10: Has to be inactive error]/type` response property for the response status `422`
  - added the new `InvalidCombination` enum value to the `errors/items/error/anyOf[subschema #8: Invalid combination error -> subschema #7: Invalid combination error]/type` response property for the response status `422`
  - added the new `MaxUsersOfPlanTypeReached` enum value to the `errors/items/error/anyOf[subschema #17: Max users of plan type reached error -> subschema #11: Max users of plan type reached error]/type` response property for the response status `422`
  - added the new `MaxUsersReached` enum value to the `errors/items/error/anyOf[subschema #18: Max users reached error -> subschema #12: Max users reached error]/type` response property for the response status `422`
  - added the new `MissingManageUsersAccessForAssigningAccessGroup` enum value to the `errors/items/error/anyOf[subschema #4: Missing manage users access for assigning access group error -> subschema #3: Missing manage users access for assigning access group error]/type` response property for the response status `422`
  - added the new `MissingManageUsersAccessForRemovingAccessGroup` enum value to the `errors/items/error/anyOf[subschema #5: Missing manage users access for removing access group error -> subschema #4: Missing manage users access for removing access group error]/type` response property for the response status `422`
  - added the new `OnlyOwnerCanDeleteOwner` enum value to the `errors/items/error/anyOf[subschema #30: Only owner can delete owner error -> subschema #20: Only owner can delete owner error]/type` response property for the response status `422`
  - added the new `RelationsPreventDeletion` enum value to the `errors/items/error/anyOf[subschema #20: Relations prevent deletion error -> subschema #13: Relations prevent deletion error]/type` response property for the response status `422`
  - added the new `ResourceConflictFound` enum value to the `errors/items/error/anyOf[subschema #14: Resource conflict found error -> subschema #9: Resource conflict found error]/type` response property for the response status `422`
  - added the new `ResourceNotFound` enum value to the `errors/items/error/anyOf[subschema #7: Resource not found error -> subschema #6: Resource not found error]/type` response property for the response status `422`
  - added the new `ResourcesInactive` enum value to the `errors/items/error/anyOf[subschema #1: Resources inactive error]/type` response property for the response status `422`
  - added the new `ResourcesNotFound` enum value to the `errors/items/error/anyOf[subschema #2: Resources not found error]/type` response property for the response status `422`
  - added the new `RunningEntriesPreventArchiving` enum value to the `errors/items/error/anyOf[subschema #22: Running entries prevent archiving error -> subschema #15: Running entries prevent archiving error]/type` response property for the response status `422`
  - added the new `RunningEntriesPreventDeletion` enum value to the `errors/items/error/anyOf[subschema #21: Running entries prevent deletion error -> subschema #14: Running entries prevent deletion error]/type` response property for the response status `422`
  - added the new `SsoPreventsDeactivation` enum value to the `errors/items/error/anyOf[subschema #23: Sso prevents deactivation error -> subschema #16: Sso prevents deactivation error]/type` response property for the response status `422`
  - added the new `UnexpectedValue` enum value to the `errors/items/error/anyOf[subschema #6: Unexpected value error -> subschema #5: Unexpected value error]/type` response property for the response status `422`
  - added the new `UserCannotDeleteThemselves` enum value to the `errors/items/error/anyOf[subschema #28: User cannot delete themselves error -> subschema #19: User cannot delete themselves error]/type` response property for the response status `422`
  - added the new `absences` enum value to the `errors/items/error/anyOf[subschema #14: Resource conflict found error -> subschema #9: Resource conflict found error]/details/resources/items/` response property for the response status `422`
  - added the new `absences` enum value to the `errors/items/error/anyOf[subschema #16: Has to be inactive error -> subschema #10: Has to be inactive error]/details/resources/items/` response property for the response status `422`
  - added the new `absences` enum value to the `errors/items/error/anyOf[subschema #20: Relations prevent deletion error -> subschema #13: Relations prevent deletion error]/details/resources/items/` response property for the response status `422`
  - added the new `absences` enum value to the `errors/items/error/anyOf[subschema #9: Email not available error -> subschema #8: Email not available error]/details/resources/items/` response property for the response status `422`
  - added the new `access_groups` enum value to the `errors/items/error/anyOf[subschema #14: Resource conflict found error -> subschema #9: Resource conflict found error]/details/resources/items/` response property for the response status `422`
  - added the new `access_groups` enum value to the `errors/items/error/anyOf[subschema #16: Has to be inactive error -> subschema #10: Has to be inactive error]/details/resources/items/` response property for the response status `422`
  - added the new `access_groups` enum value to the `errors/items/error/anyOf[subschema #20: Relations prevent deletion error -> subschema #13: Relations prevent deletion error]/details/resources/items/` response property for the response status `422`
  - added the new `access_groups` enum value to the `errors/items/error/anyOf[subschema #9: Email not available error -> subschema #8: Email not available error]/details/resources/items/` response property for the response status `422`
  - added the new `company` enum value to the `errors/items/error/anyOf[subschema #14: Resource conflict found error -> subschema #9: Resource conflict found error]/details/resources/items/` response property for the response status `422`
  - added the new `company` enum value to the `errors/items/error/anyOf[subschema #16: Has to be inactive error -> subschema #10: Has to be inactive error]/details/resources/items/` response property for the response status `422`
  - added the new `company` enum value to the `errors/items/error/anyOf[subschema #20: Relations prevent deletion error -> subschema #13: Relations prevent deletion error]/details/resources/items/` response property for the response status `422`
  - added the new `company` enum value to the `errors/items/error/anyOf[subschema #9: Email not available error -> subschema #8: Email not available error]/details/resources/items/` response property for the response status `422`
  - added the new `company_state` enum value to the `errors/items/error/anyOf[subschema #14: Resource conflict found error -> subschema #9: Resource conflict found error]/details/resources/items/` response property for the response status `422`
  - …116 more
- **2026-01-16** `e856eda71f64`: 2 breaking, 4 info
  - the `edit_lock_dyn` request property type changed from `integer` to no type
  - the `work_time_edit_lock_days` request property type changed from `integer` to no type
  - added the optional property `data/creator` to the response with the `200` status
  - added the optional property `data/nonbusinessgroups_id` to the response with the `200` status
  - added the optional property `data/worktime_regulation_id` to the response with the `200` status
  - response property `data/nonbusiness_groups_id` deprecated
- **2025-11-20** `14ad12ae7053`: 2 breaking, 2 info
  - removed the enum value `manager` of the request property `role`
  - the response property `data/wage_type` became optional for the status `200`
  - added `#/components/schemas/MissingManageUsersAccessForAssigningAccessGroupError, #/components/schemas/MissingManageUsersAccessForRemovingAccessGroupError` to the `errors/items/error` response property `anyOf` list for the response status `422`
  - removed the `manager` enum value from the `data/role` response property for the response status `200`

---

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