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

# Kombo Sandbox HRIS Integration

> Kombo Sandbox connector for Kombo's HRIS API

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

## 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             |       |
      | type                |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employees">
      | Field                 | Notes |
      | --------------------- | ----- |
      | id                    |       |
      | remote\_id            |       |
      | changed\_at           |       |
      | remote\_deleted\_at   |       |
      | employee\_number      |       |
      | first\_name           |       |
      | last\_name            |       |
      | nationality           |       |
      | display\_full\_name   |       |
      | job\_title            |       |
      | work\_email           |       |
      | personal\_email       |       |
      | mobile\_phone\_number |       |
      | ssn                   |       |
      | tax\_id               |       |
      | gender                |       |
      | ethnicity             |       |
      | marital\_status       |       |
      | employment\_status    |       |
      | employment\_type      |       |
      | weekly\_hours         |       |
      | avatar                |       |
      | work\_location\_id    |       |
      | legal\_entity\_id     |       |
      | manager\_id           |       |
      | home\_address         |       |
      | bank\_accounts        |       |
      | 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        |       |
      | approver\_id        |       |
      | start\_date         |       |
      | end\_date           |       |
      | start\_half\_day    |       |
      | end\_half\_day      |       |
      | amount              |       |
      | unit                |       |
      | status              |       |
      | employee\_note      |       |
      | type\_id            |       |
      | remote\_created\_at |       |
      | remote\_updated\_at |       |
      | remote\_data        |       |
    </Accordion>

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

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

    <Accordion title="Time Off Balances">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | type\_id            |       |
      | balance             |       |
      | balance\_unit       |       |
      | used                |       |
      | used\_unit          |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Timesheets">
      | Field                  | Notes |
      | ---------------------- | ----- |
      | id                     |       |
      | remote\_id             |       |
      | changed\_at            |       |
      | remote\_deleted\_at    |       |
      | employee\_id           |       |
      | started\_at            |       |
      | ended\_at              |       |
      | timezone               |       |
      | payable\_hours         |       |
      | unpaid\_break\_minutes |       |
      | breaks                 |       |
      | approval\_status       |       |
      | comment                |       |
      | remote\_data           |       |
    </Accordion>

    <Accordion title="Performance Reviews">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | review\_cycle\_id   |       |
      | reviewee\_id        |       |
      | reviewer\_id        |       |
      | type                |       |
      | summary\_comment    |       |
      | summary\_rating     |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Performance Review Cycles">
      | Field                       | Notes |
      | --------------------------- | ----- |
      | id                          |       |
      | remote\_id                  |       |
      | changed\_at                 |       |
      | remote\_deleted\_at         |       |
      | name                        |       |
      | review\_period\_start\_date |       |
      | remote\_data                |       |
    </Accordion>

    <Accordion title="Staffing entities">
      | Field                | Notes |
      | -------------------- | ----- |
      | id                   |       |
      | remote\_id           |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
      | name                 |       |
      | model\_type          |       |
      | description          |       |
      | status               |       |
      | employment\_types    |       |
      | number\_of\_openings |       |
      | parent\_id           |       |
      | remote\_url          |       |
      | remote\_created\_at  |       |
      | remote\_updated\_at  |       |
      | custom\_fields       |       |
      | integration\_fields  |       |
      | remote\_data         |       |
    </Accordion>

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

    <Accordion title="Staffing Entity <> Location">
      | Field                | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | location\_id         |       |
      | id                   |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
    </Accordion>

    <Accordion title="Staffing Entity <> Legal Entity">
      | Field                | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | legal\_entity\_id    |       |
      | id                   |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
    </Accordion>

    <Accordion title="Staffing entity <> Group">
      | Field                | Notes |
      | -------------------- | ----- |
      | staffing\_entity\_id |       |
      | group\_id            |       |
      | id                   |       |
      | changed\_at          |       |
      | remote\_deleted\_at  |       |
    </Accordion>
  </Tab>

  <Tab title="Actions">
    <Accordion title="Create absence">
      | Input Field       | Notes |
      | ----------------- | ----- |
      | employee\_id      |       |
      | absence\_type\_id |       |
      | status            |       |
      | start\_date       |       |
      | end\_date         |       |
      | start\_half\_day  |       |
      | end\_half\_day    |       |
      | amount            |       |
      | unit              |       |
      | employee\_note    |       |
      | start\_time       |       |
      | end\_time         |       |
    </Accordion>

    <Accordion title="Delete absence">
      | Input Field | Notes |
      | ----------- | ----- |
      | absence\_id |       |
    </Accordion>

    <Accordion title="Create employee">
      | Input Field             | Notes |
      | ----------------------- | ----- |
      | first\_name             |       |
      | last\_name              |       |
      | work\_email             |       |
      | gender                  |       |
      | job\_title              |       |
      | home\_address.street\_1 |       |
      | home\_address.street\_2 |       |
      | home\_address.city      |       |
      | home\_address.state     |       |
      | home\_address.zip\_code |       |
      | home\_address.country   |       |
      | date\_of\_birth         |       |
      | 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 |
    | --------------------- | ----- |
    | Scope Testing         |       |
    | Per Model Tests       |       |
    | Per Field Tests       |       |
    | Group Types           |       |
    | TEAM                  |       |
    | DEPARTMENT            |       |
    | COST\_CENTER          |       |
    | Custom Field Explorer |       |
    | Employees             |       |
    | Staffing entities     |       |
  </Tab>

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

      * Employees
      * Groups
      * Legal Entities
      * Locations

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

    <ResponseField name="email" type="text" required>**Private Email**<br />
    The private email address of the employee<br />
    Unified field: `private_email`</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="personal" type="object">
      **Personal Details**

      <Expandable title="properties">
        <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">**Gender**<br />
        The gender of the employee<br />
        Unified field: `gender`</ResponseField>
        <ResponseField name="nationality" type="text">**Nationality**<br />
        The uppercase two-letter ISO country (e.g., DE)<br />
        Unified field: `nationality`</ResponseField>
        <ResponseField name="mobile_phone" type="text">**Mobile Phone Number**<br />
        The mobile phone number of the employee<br />
        Unified field: `mobile_phone_number`</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="age" type="number">**Age**<br />
    The age of the employee.</ResponseField>

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

      <Expandable title="properties">
        <ResponseField name="address_line1" type="text" required>**Street 1**<br />
        The street address of the employee<br />
        Unified field: `home_address.street_1`</ResponseField>
        <ResponseField name="address_line_2" type="text" required>**Street 2**<br />
        The street address of the employee<br />
        Unified field: `home_address.street_2`</ResponseField>
        <ResponseField name="postal_code" 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="state" type="text">**State**<br />
        The state of the employee<br />
        Unified field: `home_address.state`</ResponseField>
        <ResponseField name="country" type="text">**Country**<br />
        The uppercase two-letter ISO country (e.g., DE)<br />
        Unified field: `home_address.country`</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="needs_work_permit" type="checkbox">**Needs Work Permit**<br />
    The employee needs a work permit.</ResponseField>
    <ResponseField name="allergies" type="multi_select">**Allergies**<br />
    The allergies of the employee.</ResponseField>

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

      <Expandable title="properties">
        <ResponseField name="job_title" type="text">**Job Title**<br />
        The title of the position this person is working in<br />
        Unified field: `job_title`</ResponseField>
        <ResponseField name="job_description" type="text">**Job Description**<br />
        A summary of the position and its responsibilities.</ResponseField>
        <ResponseField name="start_date" type="date" required>**Start Date**<br />
        Start date of the employee. Also considered to be the hire date<br />
        Unified field: `start_date`</ResponseField>
        <ResponseField name="work_email" type="text">**Work Email**<br />
        The email address of the employee<br />
        Unified field: `work_email`</ResponseField>
        <ResponseField name="yearly_salary" type="number">**Yearly Salary**<br />
        The yearly salary of the employee<br />
        Unified field: `yearly_salary`</ResponseField>
        <ResponseField name="probation_end_date" type="date">**Probation End Date**<br />
        The date the probation period ends for this employee.</ResponseField>
        <ResponseField name="supervisor" type="single_select">**Supervisor**<br />
        The supervisor of the employee.<br />
        References `/v1/hris/employees?remote_model=employee`</ResponseField>
        <ResponseField name="location" type="single_select">**Location**<br />
        The location of the employee.<br />
        References `/v1/hris/locations?remote_model=location`</ResponseField>
        <ResponseField name="legal_entity" type="single_select">**Legal Entity**<br />
        The legal entity the employee should be assigned to.<br />
        References `/v1/hris/legal-entities?remote_model=legal_entity`</ResponseField>
        <ResponseField name="department" type="single_select">**Department**<br />
        The department of the employee.<br />
        References `/v1/hris/groups?types=DEPARTMENT`</ResponseField>
        <ResponseField name="team" type="single_select">**Group**<br />
        The team of the employee.<br />
        References `/v1/hris/groups?types=TEAM`</ResponseField>
        <ResponseField name="work_hours" type="number" required>**Work Hours**<br />
        The work hours of the employee.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="emergency_contact" type="object">
      **Emergency Contact**

      <Expandable title="properties">
        <ResponseField name="contacts" type="array">
          **Contacts**<br />
          The contacts of the employee.

          <Expandable title="items">
            <ResponseField name="name" type="text">**Name**<br />
            The name of the contact.</ResponseField>
            <ResponseField name="phone" type="text">**Phone**<br />
            The phone number of the contact.</ResponseField>
            <ResponseField name="relationship" type="single_select">**Relationship**<br />
            The relationship of the contact.</ResponseField>
          </Expandable>
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Tab>
</Tabs>

## Integration Variants

**Current connector:** Kombo Sandbox

For **Kombo Sandbox**, we also offer the following other connector variants:

<CardGroup cols={2}>
  <Card title="Kombo Sandbox ATS" icon="https://storage.googleapis.com/kombo-assets/integrations/sandbox/icon.svg" href="/ats/connectors/sandbox">
    Kombo Sandbox for the ATS category
  </Card>

  <Card title="Kombo Sandbox Assessment" icon="https://storage.googleapis.com/kombo-assets/integrations/sandbox/icon.svg" href="/assessment/connectors/sandbox">
    Kombo Sandbox for the Assessment category
  </Card>

  <Card title="Kombo Sandbox LMS" icon="https://storage.googleapis.com/kombo-assets/integrations/sandbox/icon.svg" href="/lms/connectors/sandbox">
    Kombo Sandbox for the LMS category
  </Card>
</CardGroup>