# Integrating with Rippling

## Overview

### What is the value of the integration?

The Rippling–Drivetrain integration automatically syncs your workforce data from Rippling into Drivetrain, ensuring that headcount and employment changes stay fully up-to-date in your financial models and workforce plans.\
This removes manual data entry, reduces errors, and helps Finance and People Ops maintain a single source of truth for workforce planning.

### Why should customers use the integration?

Use this integration if you want to:

* Keep headcount models automatically current.
* Build accurate workforce planning scenarios that reflect hires, exits, and promotions.
* Avoid manual CSV uploads or reconciliations between HR and Finance systems.
* Reduce planning cycle time and improve forecast accuracy.

### When should customers use this integration?

Customers should use this integration when:

* Rippling is the system of record for HR.
* Workforce-related drivers significantly impact budgets, forecasts, and scenario plans.
* Multiple teams depend on accurate employee data for planning (Finance, HR, FP\&A, Operations).

{% hint style="info" %}
If your organization manually manages workforce information or uses another HRIS as the primary source of truth, this integration may not be required.
{% endhint %}

## Installation

### Prerequisites

Before setting up the integration, ensure:

* You have admin permissions in Rippling to install and authorize API access.
* You have permissions in Drivetrain to configure integrations.

### How to Install the Integration

{% stepper %}
{% step %}

#### Log in to Drivetrain

Navigate to **Data** → **+** Add Data Source → HRIS → Rippling.

<figure><img src="/files/S9G3A6fmAox81bcSKUVM" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click “Connect Rippling”

You’ll be redirected to Rippling’s authorization screen.

<figure><img src="/files/lnOxANyCxX235yiCxpY1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Authorize Drivetrain

Review the scopes and click **Authorize** to grant Drivetrain access to the required Rippling objects.

<figure><img src="/files/gfgpRX9Epv63yfWYtPy3" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Select access permissions

The **recommended options** to select are shown in the images below:

<figure><img src="/files/sUnQarDC1f8WStqQQlq7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PRtW4lDrm2klSJUA99HU" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ed54XzulFhAqltQMshKq" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/41TGVAdVCa8uUflGbfyW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/4tDv35iGfOeGohhbgzXU" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Complete Setup

Click on **Skip for now, go to integration** to continue.&#x20;

*Note: There's no need to setup Single sign-on (SSO) since this Rippling integration with Drivetrain uses a one-way sync.*&#x20;

<figure><img src="/files/n8MRYy18ee0t1KO7UwMf" alt=""><figcaption></figcaption></figure>

Drivetrain will begin initial data ingestion. Depending on dataset size, the initial sync may take a few minutes.

<figure><img src="/files/csa2in2Ya9RrxChQtg7N" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Data Flows

#### What data flows are available?

The integration supports the following flows:

1. **Employee Directory Sync**\
   Imports employee profiles, status, start/end dates, departments, and reporting structure.
2. **Job Sync**\
   Imports job titles, job levels.
3. **Org Structure Sync**\
   Imports departments and managers for modeling reporting and cost allocation.

#### When and how do data flows trigger?

* **Automatic Syncs**:\
  Trigger based on the frequency chosen during setup (default is daily; other sync frequencies can also be set).
* **Event-based Changes (Rippling)**:\
  When changes occur in Rippling, such as new hires, terminations, promotions, Drivetrain picks them up during the **next scheduled sync**.
* **Manual Sync**:\
  Users can trigger an immediate resync anytime from the Drivetrain Data page.

#### How to manually trigger a sync

1. Go to Data page
2. Click **Resync** icon
3. Select Rippling from the list and click Sync\ <br>

   <figure><img src="/files/34BXsQ8Ths6hYNn7V3bf" alt=""><figcaption></figcaption></figure>

### FAQs

<details>

<summary>What happens if I update an employee field in Rippling?</summary>

The next scheduled sync will automatically update the employee record in Drivetrain. You can also [manually trigger a sync](#how-to-manually-trigger-a-sync) for an immediate refresh.

</details>

<details>

<summary>Does Drivetrain write any data back to Rippling?</summary>

No. The integration is read-only. Drivetrain does not modify or push data into Rippling.

</details>

<details>

<summary>Can I choose which fields to sync?</summary>

Yes. During setup, you can select the entities and fields relevant to your planning models.

</details>

<details>

<summary>What if a field required by my Drivetrain model does not exist in Rippling?</summary>

Please contact your customer success manager. A joint request to access the scope(s) needed needs to raised with Rippling.

</details>

<details>

<summary>If I change sync frequency later, will it affect my existing data?</summary>

No. Only the timing changes. Historical data stays intact.

</details>

<details>

<summary>The sync failed—what should I do?</summary>

The reason for sync failure is displayed on the dataset page for Rippling.&#x20;

Common issues are:

* Rippling access needs to be reauthorized.
* One or more of the required fields were deleted or renamed or the datatype was modified in Rippling—you can correct this from the [**Manage Schema**](https://handbook.drivetrain.ai/getting-started/data/managing-data-schema#accessing-the-manage-schema-window) page.

In case of additional queries, please reach out to your dedicated Customer Success Manager (CSM) or send an email to <support@drivetrain.ai>.

</details>

### Support

If you encounter any issues not covered here, please contact your dedicated Customer Success Manager (CSM) or reach out to <support@drivetrain.ai>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/hris-and-ats/integrating-with-rippling.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.