> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho People HRIS Integration

> Zoho People connector for Kombo's HRIS API

The Zoho People HRIS integration allows you to sync HRIS data between Zoho People and your application through Kombo's unified API. The tool slug for this connector is `zohopeople`.

## Guides and Resources

<CardGroup cols={2}>
  <Card title="Connection Setup Guide" icon="link" href="https://help.kombo.dev/hc/en-us/articles/42520517031057-Zoho-People-How-do-I-link-my-account">
    Step-by-step instructions to connect your Zoho People account to Kombo.
  </Card>
</CardGroup>

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Employees">
      | Field                 | Notes |
      | --------------------- | ----- |
      | id                    |       |
      | remote\_id            |       |
      | changed\_at           |       |
      | remote\_deleted\_at   |       |
      | employee\_number      |       |
      | first\_name           |       |
      | last\_name            |       |
      | display\_full\_name   |       |
      | job\_title            |       |
      | work\_email           |       |
      | personal\_email       |       |
      | mobile\_phone\_number |       |
      | gender                |       |
      | marital\_status       |       |
      | employment\_status    |       |
      | employment\_type      |       |
      | avatar                |       |
      | manager\_id           |       |
      | home\_address         |       |
      | date\_of\_birth       |       |
      | start\_date           |       |
      | termination\_date     |       |
      | remote\_created\_at   |       |
      | custom\_fields        |       |
      | integration\_fields   |       |
      | remote\_data          |       |
    </Accordion>

    <Accordion title="Absence Types">
      | Field                 | Notes |
      | --------------------- | ----- |
      | id                    |       |
      | remote\_id            |       |
      | changed\_at           |       |
      | remote\_deleted\_at   |       |
      | name                  |       |
      | unit                  |       |
      | half\_days\_supported |       |
      | remote\_data          |       |
    </Accordion>

    <Accordion title="Absences">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | start\_date         |       |
      | end\_date           |       |
      | amount              |       |
      | unit                |       |
      | status              |       |
      | employee\_note      |       |
      | type\_id            |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Groups">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | type                |       |
    </Accordion>

    <Accordion title="Employee <> Group">
      | Field               | Notes |
      | ------------------- | ----- |
      | employee\_id        |       |
      | team\_id            |       |
      | id                  |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create employee">
      <Note>
        Zoho People requires an employee ID (personnel code) to create an employee. We will default it to the `work_email`, or you could provide one via remote fields.
      </Note>

      | Input Field           | Notes |
      | --------------------- | ----- |
      | first\_name           |       |
      | last\_name            |       |
      | work\_email           |       |
      | gender                |       |
      | date\_of\_birth       |       |
      | mobile\_phone\_number |       |
      | nationality           |       |
      | start\_date           |       |
    </Accordion>

    <Accordion title="Create employee (v2)">
      <Info>For detailed information about [creating employees with form](/hris/implementation-guide/create-employee), please see the [**Create Employee with Form** tab](#create-employee-with-form) above.</Info>

      | Input Field          | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | properties           |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature          | Notes |
    | ---------------- | ----- |
    | Connection Guide |       |
    | OAuth            |       |
    | Group Types      |       |
    | DEPARTMENT       |       |
  </Tab>

  <Tab title="Create Employee with Form">
    <Note>
      You can use the Invitation Method or the Direct Method to create employees in Zoho People. The Invitation Method sends an email invitation to the employee for profile setup. The Direct Method creates the employee immediately with login credentials.
    </Note>

    This integration supports multiple employee creation forms for different use cases:

    <Tabs>
      <Tab title="direct">
        <Info>
          Some **optional** form fields are referencing the following data models:

          * Employees

          Consider enabling these in your [scope configuration](/hris/features/scopes).
        </Info>

        <Warning>
          This form may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
        </Warning>

        <ResponseField name="EmployeeID" type="text" required>**Employee ID**<br />
        The unique employee identifier (personnel code) required by Zoho People.</ResponseField>
        <ResponseField name="FirstName" type="text" required>**First Name**<br />
        The first name of the employee<br />
        Unified field: `first_name`</ResponseField>
        <ResponseField name="LastName" type="text" required>**Last Name**<br />
        The last name of the employee<br />
        Unified field: `last_name`</ResponseField>
        <ResponseField name="EmailID" type="text" required>**Work Email**<br />
        The email address of the employee<br />
        Unified field: `work_email`</ResponseField>
        <ResponseField name="Dateofjoining" type="date">**Start Date**<br />
        Start date of the employee. Also considered to be the hire date<br />
        Unified field: `start_date`</ResponseField>
        <ResponseField name="Date_of_birth" type="date">**Date of Birth**<br />
        The employee's date of birth<br />
        Unified field: `date_of_birth`</ResponseField>
        <ResponseField name="Gender" type="single_select">The gender of the employee<br />
        Unified field: `gender`</ResponseField>
        <ResponseField name="Work_phone" type="text">**Mobile Phone Number**<br />
        The work phone number of the employee<br />
        Unified field: `mobile_phone_number`</ResponseField>
        <ResponseField name="password" type="text" required>**Password**<br />
        A temporary password for the employee to log in to Zoho People.</ResponseField>
      </Tab>

      <Tab title="invitation">
        <Info>
          Some **optional** form fields are referencing the following data models:

          * Employees

          Consider enabling these in your [scope configuration](/hris/features/scopes).
        </Info>

        <Warning>
          This form may contain additional custom fields that depend on your specific tool instance configuration. The exact custom fields available will vary based on your setup and cannot be displayed here.
        </Warning>

        <ResponseField name="EmployeeID" type="text" required>**Employee ID**<br />
        The unique employee identifier (personnel code) required by Zoho People.</ResponseField>
        <ResponseField name="FirstName" type="text" required>**First Name**<br />
        The first name of the employee<br />
        Unified field: `first_name`</ResponseField>
        <ResponseField name="LastName" type="text" required>**Last Name**<br />
        The last name of the employee<br />
        Unified field: `last_name`</ResponseField>
        <ResponseField name="EmailID" type="text" required>**Work Email**<br />
        The email address of the employee<br />
        Unified field: `work_email`</ResponseField>
        <ResponseField name="Dateofjoining" type="date">**Start Date**<br />
        Start date of the employee. Also considered to be the hire date<br />
        Unified field: `start_date`</ResponseField>
        <ResponseField name="Date_of_birth" type="date">**Date of Birth**<br />
        The employee's date of birth<br />
        Unified field: `date_of_birth`</ResponseField>
        <ResponseField name="Gender" type="single_select">The gender of the employee<br />
        Unified field: `gender`</ResponseField>
        <ResponseField name="Work_phone" type="text">**Mobile Phone Number**<br />
        The work phone number of the employee<br />
        Unified field: `mobile_phone_number`</ResponseField>
      </Tab>
    </Tabs>
  </Tab>
</Tabs>