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

# Rippling HRIS Integration

> Rippling connector for Kombo's HRIS API

<Note>This connector requires a partnership with Rippling. Please contact us to get access.</Note>

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

## Guides and Resources

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

## Supported Features & Coverage

<Tabs>
  <Tab title="Models">
    <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   |                                                                                                                                                                                                   |
      | employee\_number      |                                                                                                                                                                                                   |
      | first\_name           |                                                                                                                                                                                                   |
      | last\_name            |                                                                                                                                                                                                   |
      | nationality           |                                                                                                                                                                                                   |
      | display\_full\_name   |                                                                                                                                                                                                   |
      | job\_title            |                                                                                                                                                                                                   |
      | work\_email           |                                                                                                                                                                                                   |
      | personal\_email       |                                                                                                                                                                                                   |
      | mobile\_phone\_number |                                                                                                                                                                                                   |
      | gender                |                                                                                                                                                                                                   |
      | ethnicity             |                                                                                                                                                                                                   |
      | employment\_status    |                                                                                                                                                                                                   |
      | employment\_type      |                                                                                                                                                                                                   |
      | avatar                |                                                                                                                                                                                                   |
      | work\_location\_id    | Rippling exposes a /work\_locations endpoint, but it may omit some locations. We therefore parse and upsert the work location directly from the employee payload to ensure referential integrity. |
      | 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">
      <Note>
        We can't map custom absence types because Rippling doesn't expose the IDs via API.
      </Note>

      | Field                 | Notes |
      | --------------------- | ----- |
      | id                    |       |
      | remote\_id            |       |
      | changed\_at           |       |
      | remote\_deleted\_at   |       |
      | name                  |       |
      | 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\_time         |       |
      | end\_time           |       |
      | amount              |       |
      | unit                |       |
      | employee\_note      |       |
      | type\_id            |       |
      | remote\_data        |       |
    </Accordion>

    <Accordion title="Employments">
      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | job\_title          |       |
      | pay\_rate           |       |
      | pay\_period         |       |
      | employment\_type    |       |
      | 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">
      <Note>
        We currently don't support unlimited balances for Rippling. Please reach out to Kombo support if you want to read unlimited balances.
      </Note>

      | Field               | Notes |
      | ------------------- | ----- |
      | id                  |       |
      | remote\_id          |       |
      | changed\_at         |       |
      | remote\_deleted\_at |       |
      | employee\_id        |       |
      | type\_id            |       |
      | balance             |       |
      | used                |       |
      | 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">
      <Note>
        Rippling requires a personal email address to create an employee. This personal email address needs to be submitted through the `work_email` field.
      </Note>

      | Input Field             | Notes |
      | ----------------------- | ----- |
      | first\_name             |       |
      | last\_name              |       |
      | work\_email             |       |
      | gender                  |       |
      | job\_title              |       |
      | home\_address.street\_1 |       |
      | home\_address.city      |       |
      | home\_address.zip\_code |       |
      | home\_address.country   |       |
      | date\_of\_birth         |       |
      | start\_date             |       |
    </Accordion>
  </Tab>

  <Tab title="Features">
    | Feature            | Notes |
    | ------------------ | ----- |
    | Connection Guide   |       |
    | Prerequisites      |       |
    | Create credentials |       |
    | API Passthrough    |       |
    | Scope Testing      |       |
    | Per Model Tests    |       |
    | Per Field Tests    |       |
    | Group Types        |       |
    | TEAM               |       |
    | DEPARTMENT         |       |
  </Tab>
</Tabs>