> ## 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.

# Kenjo HRIS Integration

> Kenjo connector for Kombo's HRIS API

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

## Guides and Resources

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

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <Accordion title="Legal Entities">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | address             |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Work Locations">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | address             |       |
      | remote\_data        |       |
    </Accordion>

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

    <Accordion title="Absence Types">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | 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              |       |
      | type\_id            |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employments">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | pay\_rate           |       |
      | pay\_period         |       |
      | pay\_frequency      |       |
      | pay\_currency       |       |
      | effective\_date     |       |
    </Accordion>

    <Accordion title="Groups">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | name                |       |
      | type                |       |
      | remote\_data        |       |
    </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 (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   |       |
    | Prerequisites      |       |
    | Create credentials |       |
    | API Passthrough    |       |
    | Group Types        |       |
    | TEAM               |       |
    | DEPARTMENT         |       |
  </Tab>

  <Tab title="Create Employee with Form">
    <Info>
      Some **required** form fields are referencing the following data models:

      * Legal Entities

      Additionally, there are some **optional** form fields that reference:

      * Employees
      * Groups
      * Locations

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

    <ResponseField name="account" type="object" required>
      **Account**

      <Expandable title="properties">
        <ResponseField name="email" type="text" required>**Work Email**<br />
        The email address of the employee<br />
        Unified field: `work_email`</ResponseField>
        <ResponseField name="language" type="single_select">**Language**</ResponseField>
        <ResponseField name="externalId" type="text">**External ID**<br />
        A unique external identifier for the employee. Must be unique across all employees in the tenant.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="personal" type="object" required>
      **Personal**

      <Expandable title="properties">
        <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="displayName" type="text">**Display Name**</ResponseField>
        <ResponseField name="gender" type="single_select">**Gender**<br />
        The gender of the employee<br />
        Unified field: `gender`</ResponseField>
        <ResponseField name="birthdate" type="date">**Date of Birth**<br />
        The employee's date of birth<br />
        Unified field: `date_of_birth`</ResponseField>
        <ResponseField name="nationality" type="single_select">**Nationality**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="work" type="object" required>
      **Work**

      <Expandable title="properties">
        <ResponseField name="companyId" type="single_select" required>**Company**<br />
        The legal entity the employee belongs to<br />
        Unified field: `legal_entity_id`<br />
        References `/v1/hris/legal-entities?remote_model=legal_entity`</ResponseField>
        <ResponseField name="officeId" type="single_select">**Office**<br />
        Unified field: `location_id`<br />
        References `/v1/hris/locations?remote_model=location`</ResponseField>
        <ResponseField name="departmentId" type="single_select">**Department**<br />
        References `/v1/hris/groups?types=DEPARTMENT`</ResponseField>
        <ResponseField name="startDate" 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="jobTitle" type="text">**Job Title**<br />
        The title of the position this person is working in<br />
        Unified field: `job_title`</ResponseField>
        <ResponseField name="workPhone" type="text">**Work Phone**</ResponseField>
        <ResponseField name="workMobile" type="text">**Work Mobile**</ResponseField>
        <ResponseField name="isAssistant" type="checkbox">**Is Assistant**<br />
        Allow to indicate if the employee has or not the assistant role.</ResponseField>
        <ResponseField name="probationPeriodEnd" type="date">**Probation Period End**</ResponseField>
        <ResponseField name="contractEnd" type="date">**Contract End**</ResponseField>
        <ResponseField name="reportsToId" type="single_select">**Reports To**<br />
        The Kenjo employee the new employee reports to. Can be an active or inactive user, but cannot be the employee being created or someone already reporting to them.<br />
        References `/v1/hris/employees?remote_model=employee`</ResponseField>
        <ResponseField name="weeklyHours" type="number" required>**Weekly Hours**<br />
        The number of hours the employee works per week. Combined with the work schedule, this determines the day hours. Must be at least 1.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="workSchedule" type="object">
      **Work Schedule**

      <Expandable title="properties">
        <ResponseField name="mondayWorkingDay" type="checkbox">**Monday Working Day**</ResponseField>
        <ResponseField name="tuesdayWorkingDay" type="checkbox">**Tuesday Working Day**</ResponseField>
        <ResponseField name="wednesdayWorkingDay" type="checkbox">**Wednesday Working Day**</ResponseField>
        <ResponseField name="thursdayWorkingDay" type="checkbox">**Thursday Working Day**</ResponseField>
        <ResponseField name="fridayWorkingDay" type="checkbox">**Friday Working Day**</ResponseField>
        <ResponseField name="saturdayWorkingDay" type="checkbox">**Saturday Working Day**</ResponseField>
        <ResponseField name="sundayWorkingDay" type="checkbox">**Sunday Working Day**</ResponseField>
        <ResponseField name="trackAttendance" type="checkbox">**Track Attendance**<br />
        Activate or deactivate attendance tracking for the employee.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="address" type="object">
      **Address**

      <Expandable title="properties">
        <ResponseField name="street" type="text">**Street 1**<br />
        The street address of the employee<br />
        Unified field: `home_address.street_1`</ResponseField>
        <ResponseField name="postalCode" type="text">**ZIP Code**<br />
        The ZIP code of the employee<br />
        Unified field: `home_address.zip_code`</ResponseField>
        <ResponseField name="city" type="text">**City**<br />
        The city of the employee<br />
        Unified field: `home_address.city`</ResponseField>
        <ResponseField name="country" type="single_select">**Country**<br />
        Unified field: `home_address.country`</ResponseField>
        <ResponseField name="houseNumber" type="text">**House Number**</ResponseField>
        <ResponseField name="additionalAddress" type="text">**Street 2**<br />
        The street address of the employee<br />
        Unified field: `home_address.street_2`</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="financial" type="object">
      **Financial**

      <Expandable title="properties">
        <ResponseField name="accountHolderName" type="text">**Account Holder Name**</ResponseField>
        <ResponseField name="bankName" type="text">**Bank Name**</ResponseField>
        <ResponseField name="accountNumber" type="text">**Account Number**</ResponseField>
        <ResponseField name="iban" type="text">**IBAN**</ResponseField>
        <ResponseField name="swiftCode" type="text">**SWIFT Code**</ResponseField>
        <ResponseField name="nationalId" type="text">**National ID**</ResponseField>
        <ResponseField name="passport" type="text">**Passport**</ResponseField>
        <ResponseField name="nationalInsuranceNumber" type="text">**National Insurance Number**</ResponseField>
        <ResponseField name="taxCode" type="text">**Tax Code**</ResponseField>
        <ResponseField name="taxIdentificationNumber" type="text">**Tax Identification Number**</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="home" type="object">
      **Home**

      <Expandable title="properties">
        <ResponseField name="maritalStatus" type="single_select">**Marital Status**</ResponseField>
        <ResponseField name="spouseFirstName" type="text">**Spouse First Name**</ResponseField>
        <ResponseField name="spouseLastName" type="text">**Spouse Last Name**</ResponseField>
        <ResponseField name="spouseBirthdate" type="date">**Spouse Birthdate**</ResponseField>
        <ResponseField name="spouseGender" type="single_select">**Spouse Gender**</ResponseField>
        <ResponseField name="personalEmail" type="text">**Private Email**<br />
        The private email address of the employee<br />
        Unified field: `private_email`</ResponseField>
        <ResponseField name="personalPhone" type="text">**Home Phone Number**<br />
        The home phone number of the employee<br />
        Unified field: `home_phone_number`</ResponseField>
        <ResponseField name="personalMobile" type="text">**Mobile Phone Number**<br />
        The mobile phone number of the employee<br />
        Unified field: `mobile_phone_number`</ResponseField>

        <ResponseField name="children" type="array">
          **Children**

          <Expandable title="items">
            <ResponseField name="childFirstName" type="text">**First Name**</ResponseField>
            <ResponseField name="childLastName" type="text">**Last Name**</ResponseField>
            <ResponseField name="childBirthdate" type="date">**Birthdate**</ResponseField>
            <ResponseField name="childGender" type="single_select">**Gender**</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="emergency" type="object">
      **Emergency**

      <Expandable title="properties">
        <ResponseField name="emergencyFirstName" type="text">**Emergency First Name**</ResponseField>
        <ResponseField name="emergencyMiddleName" type="text">**Emergency Middle Name**</ResponseField>
        <ResponseField name="emergencyLastName" type="text">**Emergency Last Name**</ResponseField>
        <ResponseField name="relation" type="single_select">**Relation**</ResponseField>
        <ResponseField name="emergencyPhoneNumber" type="text">**Emergency Phone Number**</ResponseField>
        <ResponseField name="emergencyMobileNumber" type="text">**Emergency Mobile Number**</ResponseField>
      </Expandable>
    </ResponseField>
  </Tab>
</Tabs>
