HiBob Setup Guide
Prerequisites
- A HiBob account with Administrator permissions.
Setup Guide
Step 1: Create a service user
- Log in to your HiBob account.
- On the navigation menu, select Settings.
- Go to Integrations > Automation.
- Click Service Users.
- Click New Service User.
- Enter a Service User Name and Display Name.
- Click Save.
- Copy the Service User ID and Token - you will need both to configure your connection.
Step 2: Assign permissions to the service user
Choose one:
-
Create a new permission group
- Follow HiBob's create a custom permission group instructions.
- Remove any default conditions (e.g. Lifecycle status = Employed) so the group applies to service users.
-
Add the service user to an existing permission group
- On the navigation menu, select Settings.
- Go to Accounts > Permissions groups.
- Select the relevant group.
- Select Group actions > Edit details.
- Go to Select people by condition > Edit.
- In the Add specific employees dropdown, select Service Users, then select the service user you created above.
- Click Apply.
- Click Apply again on the Select people by condition pop-up.
Required permissions
In the permission group, grant the permissions for the streams you plan to sync. All field permissions are under People's Data > People's fields.
| Stream | HiBob permission |
|---|---|
| All employee streams | People's Data > Access data for: all employees, including terminated employees |
employee, employee_custom_fields | Basic info, Personal, About, Work: View |
employee (payroll fields) | Payroll: View |
employee_salary_history | Salary (Table): View, View history |
employee_variable_payment | Variable Pay (Table): View, View history |
employment_history | Employment: View, View history |
employee_work_history | Work: View, View history |
employee_life_cycle_history | Lifecycle (Table): View, View history |
Notes:
- HiBob does not return an error for fields the service user can't view - it leaves them out. If a column or table syncs empty, check that the permission above is granted. Without View history, history streams only return each employee's current entry.
- Matia does not read identification fields (such as SSN) or bank details. You can leave the Identification and bank account categories disabled for the service user.
Step 3: Complete Configuration in Matia
- Enter the User ID (Service User ID) you copied above.
- Enter the Token you copied above.
- Enter an Asset Name.
- (Optional) Enter a Description.
- (Optional) Assign Tags.
- Select an Owner.
- Verify that your HiBob account is successfully connected by clicking on Test Connection.
- Click Connect.