Creating Employee in Zoho People

For this API, we can pass the following parameters:

firstName
lastName
employment
- positionId
workEmail
workAddress
- id
startDate
birthDate
maritalStatus
gender
employmentType
phones
- type
- phoneNumber
department
permanentAddress
- addressLine1
- addressLine2
- city
- state
- country
- zipCode
presentAddress
- addressLine1
- addressLine2
- city
- state
- country
- zipCode

You must include the following fields in the metadata field:

employeeId (This is a user generated employee identifier eg, employee number, and is different from the internal identifier used by the app)

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: <API_KEY>' \
--data-raw '{
    "firstName": "Rohan",
    "lastName": "Kapoor",
    "employment": {
        "positionId": "207370000000283291"
    },
    "workEmail": "rohan@gmail.com",
    "workAddress": {
        "id": "4452130"
    },
    "startDate": "2025-11-20",
    "birthDate": "1993-05-10",
    "maritalStatus": "SINGLE",
    "gender": "MALE",
    "employmentType": "FULL_TIME",
    "phones": [
        {
            "type": "WORK",
            "phoneNumber": "09876512345"
        },
        {
            "type": "PERSONAL",
            "phoneNumber": "9876512345"
        }
    ],
    "department": "207370000000283279",
    "permanentAddress": {
        "addressLine1": "Greenwood Street",
        "addressLine2": "Near City Mall",
        "city": "Mumbai",
        "state": "Maharashtra",
        "country": "India",
        "zipCode": "400001"
    },
    "presentAddress": {
        "addressLine1": "Lakeview Residency",
        "addressLine2": "Block C, Flat 202",
        "city": "Pune",
        "state": "Maharashtra",
        "country": "India",
        "zipCode": "411058"
    },
    "metadata": {
        "employeeId": "1231223123"
    }
}'