Skip to content

Rippling

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

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 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 docs.

Connect a Rippling account

  1. Click Connect Account. Click Connect Account

  2. Enter a Tenant ID. This can be any ID you choose. Click Get connection link. Get connection link

  3. Open the generated link. You can also share it with your customer so they connect their own Rippling account. Share connection link

  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.

  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.