Skip to main content

Overview

The Rippling HRIS integration allows Wolfia to sync employee and organizational data from your Rippling account. Once connected, Wolfia pulls workforce data — including workers, departments, teams, titles, and work locations — so your questionnaire and RFP responses always reflect accurate, current company information.

What we sync

All data is read-only. Wolfia cannot modify, create, or delete any data in your Rippling account.
  • Workers – Employee profiles and employment details
  • Companies – Company-level information
  • Departments – Organizational department structure
  • Teams – Team assignments and hierarchy
  • Levels – Job levels and career ladder data
  • Titles – Job title information
  • Employment types – Full-time, part-time, contractor, etc.
  • Work locations – Office and remote work location data
  • Job functions – Functional area classifications
  • Functions – Business function definitions
  • Job dimensions – Additional job classification dimensions
  • Worker custom fields – Employee custom fields from Data Manager

Prerequisites

Before setting up the integration, you’ll need:
  • Admin access to your Rippling account with the ability to manage API tokens
  • A Rippling plan that supports API access

Setup instructions

Step 1: Create an API token in Rippling

Follow the instructions in the Rippling API reference to create an API token. When creating the token, give it a descriptive name (e.g., Wolfia Integration).

Step 2: Configure API permissions

Assign the following 12 read-only scopes to the API token:
ScopeDescription
workers.readRead workers data
companies.readRead companies data
departments.readRead departments data
teams.readRead teams data
levels.readRead levels data
titles.readRead titles data
employment-types.readRead employment types data
work-locations.readRead work locations data
job-functions.readRead job functions data
functions.readRead functions data
job-dimensions.readRead job dimensions data
workers.custom-fields.readRead custom field values for workers
All scopes are read-only. Wolfia does not require any write permissions to your Rippling data.

Step 3: Generate and copy the token

  1. Review the selected scopes to ensure all 12 permissions are enabled
  2. Click Create to generate the API token
  3. Copy the token value immediately
Store the token securely. If you lose access to it, you will need to generate a new one from Rippling.

Step 4: Configure Wolfia

Connect Rippling to Wolfia using the API token.
  1. Log in to your Wolfia account
  2. Go to the Expert Assignment settings page
  3. Find Rippling in the list of available integrations
  4. Click Connect Rippling
  5. Paste your API token in the provided field
  6. Click Save to complete the integration
  7. Wolfia will validate the connection and begin the initial sync

What happens after setup

Once configured, Wolfia will:
  • Import organizational data – Sync workers, departments, teams, and other HR data from Rippling
  • Continuous sync – Automatically refresh data on a recurring schedule
  • Enrich context – Use Rippling data to provide more accurate, company-specific responses to security questionnaires and RFPs

Managing the integration

Viewing sync status

  1. Go to the Expert Assignment settings page
  2. Find Rippling in the connected integrations
  3. View last sync time, record counts, and any errors

Disconnecting Rippling

  1. Go to the Expert Assignment settings page and find Rippling
  2. Click Disconnect
  3. Confirm the disconnection
  4. Your data in Rippling remains unchanged

Security considerations

  • The integration uses a scoped API token with read-only permissions
  • Wolfia cannot modify, create, or delete any data in Rippling
  • All data transmission is encrypted using HTTPS/TLS
  • API tokens are stored encrypted at rest and never exposed in logs
  • You can revoke the token at any time from Rippling’s API settings

Troubleshooting

Common issues

Connection failed
  • Verify the API token is correct and has not been revoked
  • Ensure all 12 required scopes are assigned to the token
Missing data
  • Check that the relevant scopes are enabled (e.g., departments.read for department data)
  • Verify that the data exists in your Rippling account
  • Review sync logs in Wolfia for specific error messages
Permission denied errors
  • Confirm the API token has not expired or been revoked in Rippling
  • Re-check that all required scopes are assigned

Support

If you encounter any issues during setup, contact Wolfia support at [email protected] or consult your Rippling administrator for assistance with API token permissions.