​
Before you begin

You must be a Rippling administrator to create an customer key

​
Setup Instructions

There are two different ways we can integrate with Rippling. The first option is to use your API key. The second option is to use the Rippling Reports. If you have purchased the Rippling API capability, we recommend using the API key.

​
Option 1: API Key

If you have purchased the Rippling API capability, we can use your customer key to integrate with your data.

​
Note on security

eqtble only requires a Read-Only API key and will not have the ability to modify data in your Rippling account. We always recommend creating a new API key for eqtble. This will allow you to revoke access to eqtble if needed.

​
Steps

  1. Sign in to Rippling as an admin for your organization
  2. Select Company Settings
  3. Navigate to API Access
  4. Click Create API Key
  5. Provide the following scopes to your API key
    • company
    • employee
    • company: read
    • company:activity:read
    • company:doingBusinessAsName:read
    • company:legalName:read
    • company:address:read
    • company:phone:read
    • company:departments:read
    • company:levels:read
    • company:titles:read
    • company:employmentTypes:read
    • company:customFields:read
    • company:primaryWorkLocation:read
    • company:workLocations:read
    • company:leave_requests:read
    • company:company_leave_types
    • admin:name:read
    • admin:personalEmail:read
    • admin:phone:read
    • admin:roleState:read
    • admin:department:read
    • admin:workLocation:read
    • employee:read
    • employee:name:read
    • employee:preferredFirstName:read
    • employee:preferredLastName:read
    • employee:employmentType:read
    • employee:workEmail:read
    • employee:title:read
    • employee:endDate:read
    • employee:employeeNumber:read
    • employee:department:read
    • employee:level:read
    • employee:userId:read
    • employee:isManager:read
    • employee:manager:read
    • employee:teams:read
    • employee:workLocation:read
    • employee:workLocationId:read
    • employee:customFields:read
    • employee:gender:read
    • employee:identifiedGender:read
    • employee:photo:read
    • employee:smallPhoto:read
    • groups:read
    • group_members:read
    • company:teams:read
    • insurance:read
  6. Click Save and copy the API key
  7. Login to the eqtble app.
  8. Navigate to Organization Settings.
  9. Select Integrations and select Rippling
  10. Paste your API key into the API Key field and click Save

​
Option 2: Reports

If you have not purchased the Rippling API capability, you can add eqtble as a third party in the Rippling platform.

  1. Sign in to Rippling as an admin for your organization
  2. Navigate to the Settings page
  3. On the Permission Profiles tab, click the New Permission Profile button
  4. Enter eqtble in the name field. Fill out the description if you would like.
  5. Click the Add 3rd Party User button
  6. Click on Create Permission Profile