Skip to content
Dashboard
Theme
Theme

HiBob HRIS directory sync

Set up directory sync from HiBob

View Markdown

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.

  1. 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.

  2. 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.

  3. Under Access data for, keep everyone you want to sync. The default condition, Lifecycle status equals Any, covers all employees.

  4. 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

  5. Select Preview to see who would be added, updated and removed, without changing anything.

  6. 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.

  7. 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.