--- title: "Changes to Create an employee" method: POST path: "/quickbooks-desktop/employees" --- # Changes to Create an employee `POST /quickbooks-desktop/employees` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 6 of 46 revisions. - **2026-07-20** `0b07b3ebe160` — 12 info - **2026-05-02** `1de07095c4b7` — 4 warning - **2026-05-02** `0adc2851bb7f` — 5 warning - **2026-04-20** `10d4e9ebd1df` — 46 breaking, 48 info - **2026-04-20** `8e0b7df2044d` — 47 breaking, 40 warning, 58 info - **2026-04-20** `5f832f695675` — 55 breaking, 48 info ## Changes - **2026-07-20** `0b07b3ebe160` — 12 info - added the new `AB` enum value to the request property `address/state` - added the new `BC` enum value to the request property `address/state` - added the new `MB` enum value to the request property `address/state` - added the new `NL` enum value to the request property `address/state` - added the new `NS` enum value to the request property `address/state` - added the new `NT` enum value to the request property `address/state` - added the new `NU` enum value to the request property `address/state` - added the new `ON` enum value to the request property `address/state` - added the new `PE` enum value to the request property `address/state` - added the new `QC` enum value to the request property `address/state` - added the new `SK` enum value to the request property `address/state` - added the new `YT` enum value to the request property `address/state` - **2026-05-02** `1de07095c4b7` — 4 warning - the `billingRateId` request property's maxLength was set to `36` - the `employeePayroll/classId` request property's maxLength was set to `36` - the `employeePayroll/earnings/items/payrollWageItemId` request property's maxLength was set to `36` - the `supervisorId` request property's maxLength was set to `36` - **2026-05-02** `0adc2851bb7f` — 5 warning - the `alternatePhone` request property's maxLength was set to `21` - the `fax` request property's maxLength was set to `21` - the `mobile` request property's maxLength was set to `21` - the `pager` request property's maxLength was set to `21` - the `phone` request property's maxLength was set to `21` - **2026-04-20** `10d4e9ebd1df` — 46 breaking, 48 info - response property `accountNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `additionalNotes/items/date` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `adjustedServiceDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `alternatePhone` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `birthDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `customContactFields/items/value` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `department` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `description` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `disabilityDescription` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `disabilityStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `email` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `employeeType` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `employmentStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `ethnicity` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `externalId` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `fax` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `firstName` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `gender` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `hiredDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `i9OnFileStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `jobTitle` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `keyEmployeeStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `lastName` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `middleName` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `militaryStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `mobile` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `note` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `originalHireDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `overtimeExemptStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `pager` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `pagerPin` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `phone` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `printAs` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `salutation` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `ssn` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `targetBonus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `terminationDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `usCitizenshipStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `usVeteranStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `workAuthorizationExpirationDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - …54 more - **2026-04-20** `8e0b7df2044d` — 47 breaking, 40 warning, 58 info - the response property `accountNumber` became nullable for the status `200` - the response property `additionalNotes/items/date` became nullable for the status `200` - the response property `adjustedServiceDate` became nullable for the status `200` - the response property `alternatePhone` became nullable for the status `200` - the response property `billingRate` became nullable for the status `200` - the response property `birthDate` became nullable for the status `200` - the response property `customContactFields/items/value` became nullable for the status `200` - the response property `department` became nullable for the status `200` - the response property `description` became nullable for the status `200` - the response property `disabilityDescription` became nullable for the status `200` - the response property `disabilityStatus` became nullable for the status `200` - the response property `email` became nullable for the status `200` - the response property `employeeType` became nullable for the status `200` - the response property `employmentStatus` became nullable for the status `200` - the response property `ethnicity` became nullable for the status `200` - the response property `externalId` became nullable for the status `200` - the response property `fax` became nullable for the status `200` - the response property `firstName` became nullable for the status `200` - the response property `gender` became nullable for the status `200` - the response property `hiredDate` became nullable for the status `200` - the response property `i9OnFileStatus` became nullable for the status `200` - the response property `jobTitle` became nullable for the status `200` - the response property `keyEmployeeStatus` became nullable for the status `200` - the response property `lastName` became nullable for the status `200` - the response property `middleName` became nullable for the status `200` - the response property `militaryStatus` became nullable for the status `200` - the response property `mobile` became nullable for the status `200` - the response property `note` became nullable for the status `200` - the response property `originalHireDate` became nullable for the status `200` - the response property `overtimeExemptStatus` became nullable for the status `200` - the response property `pager` became nullable for the status `200` - the response property `pagerPin` became nullable for the status `200` - the response property `phone` became nullable for the status `200` - the response property `printAs` became nullable for the status `200` - the response property `salutation` became nullable for the status `200` - the response property `ssn` became nullable for the status `200` - the response property `supervisor` became nullable for the status `200` - the response property `targetBonus` became nullable for the status `200` - the response property `terminationDate` became nullable for the status `200` - the response property `usCitizenshipStatus` became nullable for the status `200` - …105 more - **2026-04-20** `5f832f695675` — 55 breaking, 48 info - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `adjustedServiceDate` - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `birthDate` - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `employeePayroll/sickHours/accrualStartDate` - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `employeePayroll/vacationHours/accrualStartDate` - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `hiredDate` - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `originalHireDate` - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `terminationDate` - added the pattern `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$` to the request property `workAuthorizationExpirationDate` - added the pattern `^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$` to the request property `externalId` - response property `accountNumber` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `additionalNotes/items/date` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `adjustedServiceDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `alternatePhone` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `birthDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `customContactFields/items/value` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `department` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `description` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `disabilityDescription` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `disabilityStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `email` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `employeeType` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `employmentStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `ethnicity` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `externalId` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `fax` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `firstName` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `gender` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `hiredDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `i9OnFileStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `jobTitle` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `keyEmployeeStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `lastName` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `middleName` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `militaryStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `mobile` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `note` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `originalHireDate` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `overtimeExemptStatus` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `pager` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `pagerPin` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - …63 more --- [Operation](https://skmtc.dev/conductor-is/apis/conductor-api/docs/quickbooks-desktop/employees/post.md) · [API](https://skmtc.dev/conductor-is/apis/conductor-api.md) · [Page](https://skmtc.dev/conductor-is/apis/conductor-api/changes/quickbooks-desktop/employees/post)