Skip to main content

HiBob Setup Guide

Prerequisites

  • A HiBob account with Administrator permissions.

Setup Guide

Step 1: Create a service user

  1. Log in to your HiBob account.
  2. On the navigation menu, select Settings.
  3. Go to Integrations > Automation.
  4. Click Service Users.
  5. Click New Service User.
  6. Enter a Service User Name and Display Name.
  7. Click Save.
  8. 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

    1. Follow HiBob's create a custom permission group instructions.
    2. 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

    1. On the navigation menu, select Settings.
    2. Go to Accounts > Permissions groups.
    3. Select the relevant group.
    4. Select Group actions > Edit details.
    5. Go to Select people by condition > Edit.
    6. In the Add specific employees dropdown, select Service Users, then select the service user you created above.
    7. Click Apply.
    8. 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.

StreamHiBob permission
All employee streamsPeople's Data > Access data for: all employees, including terminated employees
employee, employee_custom_fieldsBasic info, Personal, About, Work: View
employee (payroll fields)Payroll: View
employee_salary_historySalary (Table): View, View history
employee_variable_paymentVariable Pay (Table): View, View history
employment_historyEmployment: View, View history
employee_work_historyWork: View, View history
employee_life_cycle_historyLifecycle (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

  1. Enter the User ID (Service User ID) you copied above.
  2. Enter the Token you copied above.
  3. Enter an Asset Name.
  4. (Optional) Enter a Description.
  5. (Optional) Assign Tags.
  6. Select an Owner.
  7. Verify that your HiBob account is successfully connected by clicking on Test Connection.
  8. Click Connect.