To connect your HiBob account to this application you must set up a new Service User. Once you create a Service User in HiBob, you will provide the Service User ID and API token in Finch Connect.
Before you start
Before you begin, please familiarize yourself with Service Users and Permissions Groups in HiBob:
- A Service User is created solely for integration or API use and is distinct from human HiBob users.
- Permissions in HiBob are then managed and assigned to users via “Permission Groups”.
Service Users and Permission groups are both found in the Settings menu of the HiBob application.
Instructions
Step 1: Create a Service User
- Log into app.hibob.com/home
- Click on the icon in the top left corner of the page and select System Settings
-
Select Integrations in the lefthand side menu and click Manage in the Service Users tile to create a new service user
- Click + New Service User and enter the Service User Name and Display Name provided in the Finch Connect screen
- Save the ID and Token - you will provide these values in the Finch Connect screen as the last step of this process
Step 2: Create a “Permission Group”
- Navigate back to the System Settings page and select Account > Permission groups
- Click + Add permission group and enter the Group Name provided in the Finch Connect screen
- Choose the option to Select people by condition and click + Select people
- Ensure the Lifecycle status equals all statuses you wish to include in the permission group and click Apply > Create user
- Navigate to the People's Data tab and enable the following permissions:
-
People > Lifecycle
- View selected employees' Lifecycle section histories
- View selected employees' Lifecycle sections
-
People > Address
- View selected employees' Address section histories
- View selected employees' Address sections
-
People > Home
- View selected employees' Home section histories
- View selected employees' Home sections
-
People > Personal Contact Details
- View selected employees' Personal section histories
-
People > Personal
- View selected employees' Personal sections
-
People > Identification
- View selected employees' Identification section histories
- View selected employees' Identification sections
- Edit selected employees' Identification sections (omit if you do not require SSN data)
-
People > Employment
- View selected employees' Employment section histories
- View selected employees' Employment sections
-
People > Payroll
-
- View selected employees' Payroll section histories
- View selected employees' Payroll sections
-
-
People > Work
-
- View selected employees' Work section histories
- View selected employees' Work sections
-
6. Click Save
Step 3: Connect your HiBob account
- Navigate back to the Finch Connect screen
- Copy and paste the Service User ID and API token you created in Step 1