Integrating Rippling

Capabilities

DataGrail's Rippling integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access Identifier Categories Email

Before You Start

To successfully configure this integration, please ensure you have sufficient privileges:

• DataGrail User Role: Super Admin, Connections Manager
• Rippling User Role: Admin

Connect to DataGrail

DataGrail provides two methods for securely connecting Rippling:

• Using OAuth (Recommended)
• Using API Keys

Connecting With OAuth (Recommended)

1. Select OAuth under Authentication Type.
2. Select the appropriate Environment from the dropdown.
3. Select Log in to Configure.
4. Sign in to Rippling.
5. Select Authorize to grant the following Employee read scopes to DataGrail.

Required API Scopes

• Read access to Custom fields
• Read access to Department
• Read access to Employee number
• Read access to Employment type
• Read access to End date
• Read access to Gender
• Read access to Identified gender
• Read access to Level
• Read access to Manager
• Read access to Name
• Read access to Title
• Read access to Work email address
• Read access to Work location
• Read access to Work location id

6. Select Everyone except contractors should get an account and select Continue.
7. Select As soon as they've signed their offer letter or agreement and select Continue.
8. Select Continue to connect your DataGrail account to Rippling.

Connecting With API Keys

Get a Rippling API Key

1. Log in to Rippling.
2. Go to Settings, then Company Settings, and then API Access.
3. Select Create API key.
4. Add a key Description and enable all Employee read scopes.

Required API Scopes

• Read Employee Custom fields
• Read Employee Department
• Read Employee Number
• Read Employee Employment type
• Read Employee Termination Date
• Read Legal Gender
• Read Identified gender
• Whether empoyee work location is remote
• Read whether empoyee work location is remote
• Read whether employee is a manager
• Permission to write the Employee's Leave balances information
• Read Employee leave balances

5. Copy your API Key and store it in a temporary, secure location.

Connect to DataGrail

1. Select API Key under Authentication Type
2. Enter the API key.
3. Select the appropriate Environment from the dropdown.
4. Select Configure Integration.

Next Steps

Now that you've successfully connected the integration, check out the following resources:

• Direct Contact Integrations
• Access Request Lifecycle
• Request Manager Overview
• Customizing Intake Forms

Troubleshooting

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details

The Rippling integration uses the Employees API:

Access Type	Synchronous

API Documentation

Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.