Skip to content

Support · Employee directory and People

Connect Rippling as the employee directory

Step-by-step: create a read-only Rippling API token, paste it on Directories Sync, then import people.

Guide

Before you start

  • Before you start: turn on MFA in Seven21. Owners and Admins need an authenticator app before Directories Sync will accept a connect. Open Account (avatar menu) or /app/mfa and finish setup (including saving recovery codes).
  • Who: Seven21 Owner or Admin, plus someone who can create API credentials in Rippling with company-wide access.
  • Time: About 10 to 15 minutes.
  • Seven21 will read: Workers (roster), users, departments, teams when granted, and optional work locations.
  • Access: read-only for directory sync. Seven21 does not remove people in the provider admin console.

Import employees with a company token. Read-only. Seven21 imports people only.

Turn on MFA in Seven21

  1. Owners and Admins need an authenticator app before Directories Sync will accept a connect.
  2. Open Account (avatar menu) or /app/mfa, finish setup, and save recovery codes.

Create a Rippling API token

  1. In Rippling, open Developer, then API credentials. If menus differ, search for API credentials.
  2. Choose New API token.
  3. Name the token for Seven21. Leave the API version Rippling selects.
  4. Grant only the read permissions below. Do not add write permissions.
  5. Confirm the token owner permission profile covers the entire company. A manager-scoped token only returns that person's reports.
  6. Create the token and copy it immediately. Rippling will not show the full token again.

Required read permissions

companies.read
workers.read
users.read
departments.read
teams.read

Optional read permission

work-locations.read

Read only: Seven21 only sends read requests. It does not create hires or change people in Rippling. App assignments for other products are not on this API.

Connect in Seven21

  1. Open Directories Sync in the Admin group of the left sidebar.
  2. On the Rippling card, click Connect (or Manage if reconnecting).
  3. In API token, paste the token (one line, no Bearer prefix).
  4. Click Test and connect. Seven21 calls Rippling once to confirm the token, then stores it encrypted and opens Import preview.

Permissions checklist

  • companies.read: Confirms the token before it is saved.
  • workers.read: Roster, title, manager, start date, and employment status.
  • users.read: Name and work email.
  • departments.read: Department name and synced department groups.
  • teams.read: Synced Rippling team groups. Import still works without it.
  • work-locations.read (optional later): Optional. Office name. Remote workers are labeled Remote without it.

Confirm it worked

Connection saved. Import preview lists people Seven21 can read. After Import, employees appear under People. Use Sync now anytime; Seven21 also runs a daily sync.

Troubleshooting

  • Unauthorized or rejected token: Create a new token and paste it again. Do not reuse a truncated copy.
  • Refused or forbidden: Add the required read permissions above, and use a token owner who can see the whole company.
  • Rate limited: Wait a minute, then Sync now.
  • Missing team groups: Add teams.read and reconnect or Update credentials.

Signed in? Open this guide in Help Center · Contact support

Start your shared spend workspace.

Create a company with your work email, add the apps you pay for, connect directories when ready, and invite Finance and IT.

Full access for 14 days · Work email required · No card upfront