# Rippling

> Source: https://truto.one/docs/integration-guides/rippling/

Rippling connects with an API token. The token can reach only the data that both its scopes and its owner's permissions allow.

:::callout{type="info"}
- You need the **Manage the API Tokens app** or **Create and manage API Tokens** permission in Rippling.
:::

## Install the Rippling integration

Install Rippling from [Available integrations](https://app.truto.one/integrations/available/5d77db70-f87a-445a-9490-0af7af4b5e79) in each environment you connect accounts from.

## Create an API token

1. In Rippling, go to **Developer** → **API credentials** and click **New API token**.
2. Enter a **Name**, a **Unique identifier** and the **API version**.
3. Assign the scopes for the data you need.
4. Copy the token at the end of the flow. Rippling doesn't show it again.

The token acts as its owner. Rippling revokes it if the owner is terminated or if it goes unused for more than 30 days, and changes to the owner's permissions apply to the token too. See Rippling's [API tokens](https://developer.rippling.com/documentation/rest-api/essentials/api-tokens) docs.

## Connect a Rippling account

1. Click **Connect Account**.
   ![Click Connect Account](https://docs-assets.truto.one/truto-connect-account.png)
2. Enter a Tenant ID. This can be any ID you choose. Click **Get connection link**.
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)
3. Open the generated link. You can also share it with your customer so they connect their own Rippling account.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)
4. Select **Rippling**.
5. Fill in the form and click **Connect**:

   | Field | Required | What to enter |
   |---|---|---|
   | **API Token** | Yes | The Rippling API token. See [Create an API token](#create-an-api-token). |
6. Close the tab when you see the connection successful message. The new account appears under **Integrated Accounts**. Click its Account ID to see its details and make API calls.