Rippling

Harmony supports Rippling as an HRIS integration, allowing you to connect your Rippling account directly from the integrations settings. Once connected, your Rippling API token is stored encrypted, keeping your credentials secure.

Employee data sync from Rippling is not yet active in the current release. Full sync support - including automatic employee record updates - is coming in a follow-up update once the integration is fully validated.

Prerequisites

Before connecting Rippling, make sure you have the following:

• An active Rippling account with API access enabled
• A Rippling API token with the permissions listed in Required API Token Permissions
• Admin access to your Harmony workspace

Required API Token Permissions

When you create the API token in Rippling, grant it read access to the following data objects. Harmony reads employee data only - it never writes back to Rippling.

Scope	Data object	Why Harmony needs it
workers.read	Workers	The core employee record: employment status, job title, start and end dates, work email, and the manager relationship used to build your reporting hierarchy.
users.read	Users	Employee first and last name, display name, time zone, and profile photo.
departments.read	Departments	The department each employee belongs to.
employment-types.read	Employment types	Full-time, part-time, and temporary classification, plus whether the person is an employee or a contractor.

These four scopes are all Harmony reads - no other Rippling data is accessed. If the token is missing any of them, Rippling returns an insufficient scopes error and the sync will not complete.

If you adjust the token's permissions later, the change takes effect on the next sync - you do not need to reconnect the integration.

Connect Your Rippling Account

To link your Rippling account to Harmony:

1. In Harmony, navigate to Settings and open the Integrations section.
2. Locate Rippling in the HRIS integrations list and click Connect.
3. Enter your Rippling API token in the provided field.
4. Click Save to confirm the connection.

Once saved, your API token is encrypted and stored securely. Harmony will confirm that the connection was established successfully.

What to Expect Next

With this initial release, the connection between Harmony and Rippling is established and your credentials are securely stored. Active employee data sync - including automatic creation and updates of employee records - is not yet available but is planned for a follow-up update.

When full sync support becomes available, you will not need to reconnect your account. The integration will use your existing connection to begin syncing employee data automatically.

Disconnect Rippling

If you need to remove the Rippling integration at any time:

1. Go to Settings and open the Integrations section.
2. Find Rippling and click Disconnect.
3. Confirm the action when prompted.

Disconnecting will remove your stored API token from Harmony.