> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sourcemedium.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Rippling - Integration Instructions

> Land Rippling worker records in your warehouse as raw tables.

<Note>Raw data only. Rippling lands as warehouse tables. People analytics are not modeled in dashboards or Uni yet.</Note>

Rippling is your HR and payroll system. SourceMedium reads worker records into BigQuery.

<Info>
  You connect data sources yourself in SourceMedium. Sign in to your [SourceMedium account](https://urchin.sourcemedium.com), open your store, then in the **Data sources** section click **Connect data source** and choose the platform. You need an **Editor** or **Admin** role on the store. If you have view-only access, ask an admin or editor on your team to connect it.

  Once it is connected, [what happens next](/docs/data-inputs/platform-integration-instructions/after-you-connect) covers first-sync timing and what each connection status means.
</Info>

## How to connect

<Steps>
  <Step title="Create a Rippling API key">
    In Rippling, create an API key with read access to workers.
  </Step>

  <Step title="Request setup">
    Find **Rippling** in the connector picker and click **Request setup**. Send the API key to your account manager or [integrations@sourcemedium.com](mailto:integrations@sourcemedium.com), not in a public channel.
  </Step>
</Steps>

<Note>
  SourceMedium only ever reads from your connected platforms. It does not create, change, or delete anything, so create the key with **read-only** access wherever the platform offers it. Treat it like a password: keep it confidential and avoid sharing it over email or in spreadsheets. If the credential is rotated or revoked, follow this guide's connection method to update SourceMedium.
</Note>

## What data syncs

Worker records, including department and employment type where the API provides them.

### Notes

* Query the warehouse directly until transformed models exist.
