Creating Employee in Oracle HCM

For this API, we can pass the following parameters:

firstName
lastName
employment
- positionId
workEmail
startDate
birthDate
employmentType
presentAddress
- addressLine1
- addressLine2
- city
- state
- country
- zipCode
companyId or LegalEntityId
employeeNumber (This is a user-generated employee identifier, similar to an employee code or number)

A cURL request to create an employee could look like this:

curl --location 'https://api.getknit.dev/v1.0/hr.employee.create' \
--header 'X-Knit-Integration-Id: <INTEGRATION_ID>' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_KEY>' \
--data-raw '{
    "firstName": "Mason",
    "lastName": "Clark",
    "employment": {
        "positionId": "300000182860864"
    },
    "workEmail": "[email protected]",
    "startDate": "2025-03-12",
    "birthDate": "1989-07-29",
    "employmentType": "FULL_TIME",
    "presentAddress": {
        "addressLine1": "742 Evergreen Terrace",
        "addressLine2": "Apt 5B",
        "city": "Springfield",
        "state": "IL",
        "country": "US",
        "zipCode": "62704"
    },
    "companyId": "300000157362965",
    "employeeNumber": "93647281"
}'