Overview

Torii integrates with HiBob and syncs: Users list - All employees with company email, Status & License.

Torii supports multiple HiBob accounts.

Prerequisite

• Make sure you have HiBob Account and an admin user
• You will be asked to provide the following details in Torii during the integration:
  
  
• The following instructions will guide you to create a new HiBob Service User and a new HiBob Permission Group:

STEP 1: Create a Service User

• Login to your HiBob account and go to the Service Users page.
• Click New Service User
  
• For "Service User Name" fill "torii integration" and for "Display name" fill "Torii integration"
  

• Copy the ID and Token.
  

STEP 2: Create a Permission Group

• Go to HiBob's Permission groups page and click Create Group
  
  
• Name the group "Torii integration" and In the Group members section at the bottom, click Edit
  
• In the popup:
  1. In the Conditions section, make sure none are selected by clicking the Trash icon
  2. Choose the Torii integration service user in the Add Specific Employees dropdown
  3. Click Apply
     
• Click Create
  

• We will now set the Group's permissions. Make sure you select all of the 7 following permissions in order to sync data correctly into Torii:

  • 1. People's data tab > People > Basic Info > View selected employees' Basic info sections

    • 

  • 2. People's data tab > People > Lifecycle > View selected employee's Lifecycle sections

    3. People's data tab > People > Lifecycle > View selected employee's Lifecycle section histories

    
  • 4. People's data tab > People > Employment > View selected employees' Employment section histories
    5. People's data tab > People > Employment > View selected employees' Employment sections
    6. People's data tab > People > Employment History > View selected employees' Employment History section histories
    7. People's data tab > People > Employment History > View selected employees' Employment History sections
    
    

Please note:
1) If you cannot find a section described above in HiBob, this is likely due to that section being internally renamed or archived. Please look for the relevant permissions in other sections (including archived sections) and add them. If you still cannot find them, please contact HiBob support. 

2) If you archive one of these sections after connecting the integration, the integration will fail as Torii will no longer have API access to the relevant fields. 

Connect HiBob integration to Torii

To connect HiBob to Torii, follow the below steps:

1. Go to the Integrations page and select the HiBob tile.
   
2. Connect to HiBob.
3. In Connect HiBob, enter the Access Token and the Service User ID
4. Click Connect.
   
   
5. The "Test Connection" window will make the connection test. Note that the test might take about 30 seconds.
   Click Connect to continue.
   
   
6. Once the integration is connected and synced, it will display a green checkbox.
   

Update the User Lifecycle settings.

To ensure you get the user lifecycle information in Torii, define HiBob as your Human resource management system.

1. Under Settings >> User Lifecycle, click the Edit button to review the options.
2. Select HiBob
3. In case HiBob is your only source for user management, make sure to
   uncheck Azure and Google workspace
4. Click Preview changes
5. Apply changes
   
   

On the next scheduled sync, the user's status will be reflected in Torii