Skip to content
Dashboard
Theme
Theme

Rippling HRIS directory sync

Set up directory sync from Rippling

View Markdown

Create a Rippling API token that can read your employees, enter it in this setup, and we read your employee list every few minutes.

The values in braces, such as {acs_url}, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.

  1. Use this guide when you want this app to read people straight from Rippling’s employee records. If you manage app access with Rippling’s SCIM provisioning instead, follow the Rippling SCIM guide.

  2. As a Rippling admin, create an API token in Rippling’s API access settings with read access to employee records. Copy the token when it is shown.

  3. Paste the API token in this setup. We check it with one read from Rippling before saving it encrypted; if the check fails, nothing is saved.

  4. The first sync starts right away. After that we read Rippling every 5 minutes; after a failure we wait longer between tries, up to an hour.

  5. We read the full employee list on every sync. People Rippling no longer returns are removed from the directory, and changes to names, titles or departments are updated.

  6. If you revoke the token or it expires, syncs fail and this setup shows the error. Create a new token and enter it here again.

  7. After the first sync, check in this setup that the people you expect are listed with the right names and emails.