# 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="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2F1p73cc4RWi5mFyOwh7zm%2FRippling-Drivetrain-Connect-your-rippling-account.png?alt=media&#x26;token=b37a7d2f-f1c1-4aa9-be4d-c9e0a249064a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Click “Connect Rippling”

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

<figure><img src="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2F5AtQMBAu8Ev3FbgMzzM2%2FRippling-Drivetrain-authorization-screen.png?alt=media&#x26;token=4a68c52f-6c5a-4d65-9674-5b374dcd7905" 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="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2FBP0BAUIufbUy7ivMMiya%2FRippling-Drivetrain-authorize-permissions.png?alt=media&#x26;token=79e8089c-2e5e-4715-a85b-d28bc055d334" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Select access permissions

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

<figure><img src="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2FvSeWP1Z6klWVWFdfv9g3%2Fimage.png?alt=media&#x26;token=843b4b99-0859-42ef-84e1-57174267100e" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2F661cF6Uf5XeNovq7MAKh%2FRippling-Drivetrain-access-rules.png?alt=media&#x26;token=d72fb741-c4a5-4645-9ae4-d4da02370626" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2FqNK0VAcAr65DBlkQV54b%2FRippling-Drivetrain-connect-account.png?alt=media&#x26;token=e45f2169-3735-4a4a-980c-fd7f19d20b91" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2Fy3BdWcKDDvPIjXZttjtr%2FRippling-Drivetrain-integration-progress-screen.png?alt=media&#x26;token=5d3f2dd7-5ce5-46bc-a395-48841ad2d7b8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2FYHMKB1Q5liN3beLaf5sY%2FRippling-Drivetrain-integration-progress-screen-2.png?alt=media&#x26;token=bb2cade6-92c0-48d7-9dc9-1496a6a7b35c" 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="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2FoBLL3IoeYW2bz1oS2jJp%2FRippling-Drivetrain-integration-complete.png?alt=media&#x26;token=937b8634-065a-4786-9966-0d6706e11a46" 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="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2FpnMUFb0XvA0Cc655CdFN%2FRippling-Drivetrain-sync-in-progress.png?alt=media&#x26;token=fa645029-c2ac-4970-af58-6e7d28769b64" 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="https://4220329029-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmBZR0D9lq6jrI895OuOU%2Fuploads%2FWik70nGr4m0tdU3Y7QOS%2FScreenshot%202025-11-17%20at%2011.46.21%E2%80%AFAM.png?alt=media&#x26;token=1d2887e8-7574-4c8d-a3d4-58ae6efeb939" 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>.