> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/hris/rippling.md).

# Rippling

Harmony supports Rippling as an HRIS integration, allowing you to connect your Rippling account directly from the integrations settings. Once connected, your Rippling API token is stored encrypted, keeping your credentials secure.

{% hint style="info" %}
Employee data sync from Rippling is not yet active in the current release. Full sync support - including automatic employee record updates - is coming in a follow-up update once the integration is fully validated.
{% endhint %}

### Prerequisites

Before connecting Rippling, make sure you have the following:

* An active Rippling account with API access enabled
* A Rippling API token with sufficient permissions to read employee data
* Admin access to your Harmony workspace

### Connect Your Rippling Account

To link your Rippling account to Harmony:

1. In Harmony, navigate to **Settings** and open the **Integrations** section.
2. Locate **Rippling** in the HRIS integrations list and click **Connect**.
3. Enter your Rippling API token in the provided field.
4. Click **Save** to confirm the connection.

Once saved, your API token is encrypted and stored securely. Harmony will confirm that the connection was established successfully.

### What to Expect Next

With this initial release, the connection between Harmony and Rippling is established and your credentials are securely stored. Active employee data sync - including automatic creation and updates of employee records - is not yet available but is planned for a follow-up update.

When full sync support becomes available, you will not need to reconnect your account. The integration will use your existing connection to begin syncing employee data automatically.

### Disconnect Rippling

If you need to remove the Rippling integration at any time:

1. Go to **Settings** and open the **Integrations** section.
2. Find **Rippling** and click **Disconnect**.
3. Confirm the action when prompted.

Disconnecting will remove your stored API token from Harmony.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/integrations/hris/rippling.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
