# Rippling

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

Rippling's directory and lifecycle events drive Day-1 onboarding, offboarding, and access workflows, with Rippling-managed roles flowing into Siit's workflow conditions.

### What you get

* **Live People directory** — Rippling employees and contractors appear in Siit with their full profile.
* **Lifecycle triggers** — Start date, End date, Work anniversary, and Birthday flow into Siit as workflow triggers.
* **Manager resolution** — Rippling's reporting structure drives auto‑selected approvers.
* **Department, team, and location hierarchies** — preserved in Siit for routing, audiences, and reporting.
* **Multi‑entity support** — for customers with multiple Rippling legal entities, each worker's entity is attached.

### What syncs from Rippling

| Category        | Fields                                                                         |
| --------------- | ------------------------------------------------------------------------------ |
| Identity        | Preferred name, legal name, work email, Rippling Employee ID                   |
| Role            | Job title, job level, department, team                                         |
| Org structure   | Manager, work location, legal entity, cost center                              |
| Employment      | Employment type (Employee / Contractor), status (active, on leave, terminated) |
| Lifecycle dates | Start date, termination date, date of birth                                    |
| Custom          | Selected custom fields (Custom Field Groups you enable in Rippling)            |

Work email is the canonical identifier.

### Before you connect

* You'll need **Rippling admin access** with permission to install third‑party apps.
* Siit is installed via Rippling's app directory — your Rippling admin policy must allow this.
* Decide which Rippling role / Custom Field Groups Siit should be able to read.

### Connect Rippling

1. In Siit, go to **Settings → Integrations**.
2. Find **Rippling** in the HRIS section and click **Connect**. You'll be redirected to Rippling.
3. Sign in to Rippling if prompted.
4. Review and approve the requested data scopes:
   * Read employees and contractors
   * Read departments, teams, work locations, legal entities
   * Read custom fields (if enabled)
5. Confirm the install. Rippling redirects you back to Siit.
6. Siit runs an initial import and shows a preview.
7. Review the field mapping and click **Finish setup**.

> **Tip** — If you manage access strictly via Rippling Custom Roles, check with your Rippling admin that the admin performing the install has access to every employee you want synced. The scope is inherited at install time.

### After the connection

* **Check your People list** in Siit — confirm the count matches Rippling's active employees + contractors.
* **Set source of truth** — in **Settings → People → Fields**, pick Rippling for HR fields (department, manager, legal entity, employment type).
* **Map custom fields** — in **Settings → Integrations → Rippling**, select which custom fields you want in Siit.
* **Build workflows** — Rippling customers often want onboarding and offboarding workflows that pair HR data (Rippling) with provisioning steps (IdP, apps).

### Sync frequency

Rippling data refreshes automatically every few hours. Force a manual sync from **Settings → Integrations → Rippling → Sync now**.

### Common workflows

**Day‑1 onboarding.** *Trigger: Start date. Actions: create IdP account, assign department‑specific app bundle, ship equipment, notify manager.*

**Offboarding on termination.** *Trigger: End date. Actions: revoke sessions, remove app access, create equipment pickup request, DM manager with handover reminder.*

**Department‑aware routing.** *Condition: Requester's department = Engineering → Route to IT Ops; else → Route to general helpdesk.*

**Contractor onboarding.** *Trigger: Start date, Condition: Employment Type = Contractor. Actions: create limited IdP account, assign contractor app bundle only.*

### Note on Rippling IT

If you use **Rippling IT** for provisioning apps and devices in addition to HRIS, Siit currently consumes Rippling as an HR source of truth — provisioning actions triggered from Siit still flow through your IdP or the target apps directly. Reach out via in‑app chat if you'd like Rippling IT actions exposed natively in Siit workflows.

### Troubleshooting

**Missing employees.** The installing admin's scope limits what Siit can see. Ask an admin with unrestricted scope to re‑authorize the connection from **Settings → Integrations → Rippling → Reauthorize**.

**Custom field didn't appear.** Confirm the custom field is enabled at the API level in Rippling and included in the install scope, then re‑run mapping.

**Manager is empty.** In Rippling, confirm a reporting manager is assigned on the employee's profile.

**"App not authorized" on reconnect.** Rippling may have revoked the token after an admin change. Go through the install flow again.


---

# 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://docs.siit.io/integrations/hris/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.