---
title: "Changes to Create a new employee"
method: POST
path: "/employees"
---

# Changes to Create a new employee

`POST /employees`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 28 revisions.

- **2026-07-13** `80675117301b`: 1 info
- **2025-09-10** `417afc890070`: 1 info
- **2025-01-24** `512d594a5f71`: 1 info
- **2025-01-24** `542ef1d43cc7`: 13 breaking, 7 warning, 3 info
- **2025-01-17** `4573748c6338`: 5 info
- **2025-01-16** `3a97c5571c57`: 1 breaking, 2 warning, 1 info
- **2025-01-09** `a59b7402c514`: 3 breaking, 2 info
- **2025-01-09** `29074eeb2bb5`: 5 info
- **2025-01-07** `659ddbe31a58`: 16 breaking, 5 warning, 14 info

## Changes

- **2026-07-13** `80675117301b`: 1 info
  - added the optional property `departmentId` to the response with the `201` status
- **2025-09-10** `417afc890070`: 1 info
  - added the required property `officeCode` to the response with the `201` status
- **2025-01-24** `512d594a5f71`: 1 info
  - added the required property `employment/employedFor` to the response with the `201` status
- **2025-01-24** `542ef1d43cc7`: 13 breaking, 7 warning, 3 info
  - added the new required request property `employment`
  - added the new required request property `officeCode`
  - added the new required request property `position`
  - the `office` response property's minItems was decreased from `2` to `0` for the response status `201`
  - the `office` response's property type changed from `array` to `string` for status `201`
  - removed the required property `contractType` from the response with the `201` status
  - removed the required property `expiresAt` from the response with the `201` status
  - removed the required property `firstName` from the response with the `201` status
  - removed the required property `hiredAt` from the response with the `201` status
  - removed the required property `lastName` from the response with the `201` status
  - removed the required property `personalInfo/dateOfBirth` from the response with the `201` status
  - removed the required property `salary` from the response with the `201` status
  - removed the required property `title` from the response with the `201` status
  - removed the request property `contractType`
  - removed the request property `expiresAt`
  - removed the request property `hiredAt`
  - removed the request property `office`
  - removed the request property `personalInfo/age`
  - removed the request property `salary`
  - removed the request property `title`
  - added the required property `employment` to the response with the `201` status
  - added the required property `name` to the response with the `201` status
  - added the required property `position` to the response with the `201` status
- **2025-01-17** `4573748c6338`: 5 info
  - added the optional property `errorGUID` to the response with the `400` status
  - added the optional property `errorGUID` to the response with the `409` status
  - added the optional property `errorGUID` to the response with the `422` status
  - added the optional property `errorGUID` to the response with the `500` status
  - added the optional property `errorGUID` to the response with the `503` status
- **2025-01-16** `3a97c5571c57`: 1 breaking, 2 warning, 1 info
  - added the new required request property `departmentId`
  - removed the request property `department`
  - added the new `IN` enum value to the `nationality` response property for the response status `201`
  - added the new `IN` enum value to the request property `nationality`
- **2025-01-09** `a59b7402c514`: 3 breaking, 2 info
  - the response property `code` became optional for the status `400`
  - the response property `code` became optional for the status `500`
  - the response property `code` became optional for the status `503`
  - added the non-success response with the status `409`
  - added the non-success response with the status `422`
- **2025-01-09** `29074eeb2bb5`: 5 info
  - removed the pattern `^[+]?[(]?[0-9]{1,4}[)]?[-\s\./0-9]*$` from the request property `personalInfo/phone`
  - added the media type `application/json` for the response with the status `400`
  - added the non-success response with the status `500`
  - added the non-success response with the status `503`
  - the `personalInfo/phone` response's property pattern `^[+]?[(]?[0-9]{1,4}[)]?[-\s\./0-9]*$` was removed for the status `201`
- **2025-01-07** `659ddbe31a58`: 16 breaking, 5 warning, 14 info
  - added the new required request property `contractType`
  - added the new required request property `department`
  - added the new required request property `expiresAt`
  - added the new required request property `hiredAt`
  - added the new required request property `office`
  - added the new required request property `personalInfo/age`
  - added the new required request property `salary`
  - added the new required request property `title`
  - removed the enum value `IN` of the request property `nationality`
  - added the pattern `^[+]?[(]?[0-9]{1,4}[)]?[-\s\./0-9]*$` to the request property `personalInfo/phone`
  - removed the media type `application/json` for the response with the status `400`
  - the `office` response's property type changed from `string` to `array` for status `201`
  - removed the required property `employment` from the response with the `201` status
  - removed the required property `name` from the response with the `201` status
  - removed the required property `officeCode` from the response with the `201` status
  - removed the required property `position` from the response with the `201` status
  - removed the request property `departmentId`
  - removed the request property `employment`
  - removed the request property `officeCode`
  - removed the request property `position`
  - removed the optional property `departmentId` from the response with the `201` status
  - removed the non-success response with the status `409`
  - removed the non-success response with the status `422`
  - removed the non-success response with the status `500`
  - removed the non-success response with the status `503`
  - removed the `IN` enum value from the `nationality` response property for the response status `201`
  - the `personalInfo/phone` response's property pattern `^[+]?[(]?[0-9]{1,4}[)]?[-\s\./0-9]*$` was added for the status `201`
  - added the required property `contractType` to the response with the `201` status
  - added the required property `expiresAt` to the response with the `201` status
  - added the required property `firstName` to the response with the `201` status
  - added the required property `hiredAt` to the response with the `201` status
  - added the required property `lastName` to the response with the `201` status
  - added the required property `personalInfo/dateOfBirth` to the response with the `201` status
  - added the required property `salary` to the response with the `201` status
  - added the required property `title` to the response with the `201` status

---

[Operation](https://skmtc.dev/ducin-public/apis/itcorpo-api/docs/employees/post.md) - [API](https://skmtc.dev/ducin-public/apis/itcorpo-api.md) - [Page](https://skmtc.dev/ducin-public/apis/itcorpo-api/changes/employees/post)
