Create a HiBob API service user that can read employee data, enter its ID and token in this setup, and we read your people 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.
-
Create an API service user
Section titled “Create an API service user”As a Bob admin, create an API service user for OhAuthCat. Copy its ID and token when they are shown; the token is shown only once.
-
Give the service user read access
Section titled “Give the service user read access”Add the service user to a permission group. Under People’s data, grant View on the Default Employee Fields (the root, about, employment and work categories). Grant nothing that edits data.
-
Choose whose data it can read
Section titled “Choose whose data it can read”Under Access data for, keep everyone you want to sync. The default condition, Lifecycle status equals Any, covers all employees.
-
Enter the credentials in this setup
Section titled “Enter the credentials in this setup”Enter the service user ID and token. We search your people once to check them before saving them encrypted; if the check fails, nothing is saved.
Fixes:
directory_source_credentials_invalid,directory_source_unavailable -
Preview the first sync
Section titled “Preview the first sync”Select Preview to see who would be added, updated and removed, without changing anything.
-
Choose how often we read HiBob
Section titled “Choose how often we read HiBob”We read HiBob every 5 minutes by default. You can set any interval from 5 minutes to 24 hours. After a failure we wait longer between tries, up to an hour.
-
Know who is synced
Section titled “Know who is synced”Every sync reads the full list of people. People who leave, or whom the service user can no longer see, are removed from the directory, and departments become groups.
Sources
Section titled “Sources”- API Service users (HiBob), read on 2026-10-30
- Permissions (HiBob), read on 2026-10-30