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 permission group -> Service user
  
  
• Name the group "Torii integration" and In the Members section at the bottom, select the service users you created.
  
• Click Create
• Go to Account > Permission groups and select the group you just created.
• Navigate from Features to People's Data, make sure you are on the "Access data for" option in the middle column, then press Edit Permissions on the top right.
  
• Change the settings for Whose data can members access:
  
  • Select Select people by condition
  • Press Edit
  • Change the condition to Lifecycle status > Equals > select all lifecycle statuses
    

• We will now set the Group's permissions. Make sure you select all of the 5 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
    

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