Rippling

Audience: Administrators

Overview

Rippling is a cloud-based workforce management platform. OrgChart can connect directly to Rippling to pull HR data.

The following article provides information on:

• Frequently asked questions regarding OrgChart's integration with Rippling
• Instructions on how to configure your Rippling account for OrgChart integration
• Instructions on how to set up your Rippling integration in OrgChart
• Rippling field compatibility

Rippling integration FAQ

1. How do I set up my connection to Rippling?

   After configuring your Rippling account for OrgChart integration, reference the Setting up a Rippling integration in OrgChart section below.

2. Can I pull photos from Rippling into my org charts?

   No. Photos are not currently supported by the Rippling connector.

3. What fields can I pull from Rippling?

   Reference the Rippling field compatibility section below for a list of the fields that OrgChart can pull from Rippling.

4. Can I merge data from a secondary source with Rippling data?

   Yes. Reference the OrgChart data integrations articles to ensure that OrgChart supports the source you wish to combine with Rippling.

5. Can I embed org charts (generated from Rippling data) into my intranet?

   Yes. Reference the Web links article for more information.

6. Can I filter which records are included in my org charts?

   Yes. Reference the Import filters article for more information.

Configuring your Rippling account for OrgChart integration

To connect OrgChart to Rippling, you need to generate an API token in Rippling with the appropriate scopes. 

1. Log in to Rippling as an administrator, and then follow this documentation outlined on Rippling's developer portal for generating API tokens.
    

Important

The API token is only displayed once. Copy and store it before closing the window. If you lose the token, you will need to generate a new one.

2. Select the scopes required to allow OrgChart to read employee and organizational data from Rippling. At minimum, enable the following scopes:
    
   • employment-types.read — Read employment types data available to the authorized client
   • workers.read — Read workers data available to the authorized client
   • workers.custom-fields.read — Read custom field values for workers
   • users.read — Read users data available to the authorized client

Setting up a Rippling integration in OrgChart

1. Click on the Settings button in the bottom right corner, and then select the Chart Settings option from the list. 

   

2. Click on the Change data source button, and then select the Rippling option from the data source menu.
    

3. Paste the API token generated from your Rippling account into the API Token text box. Leave the Domain text box empty.

   

4. Click on Save to preserve your changes.
    
5. Click on Save in the Chart Settings: Data sources panel, and then click on Refresh.
    

Rippling field compatibility

The following fields are available to be pulled into OrgChart:

Rippling Field	OrgChart Field
department.name	Department Name
work_email (personal_email as fallback)	Email
number	Employee Number
id (Internal, unique ID for identifying employees)	Employee ID
user.name.given_name	First Name
user.name.formatted	Full Name
title	Job Title
user.name.family_name	Last Name
manager_id (Internal, used to identify an employee's manager)	Manager ID
department_id	Department ID
employment_type.type	Employment Type
overtime_exemption	FLSA Status
start_date	Hire Date
level_id	Job Code
manager.number	Manager Employee Number
user.name.middle_name	Middle Name
status	Status
end_date	Termination Date
user_id	User ID