How can we help?

Hibob Integration

Noga Tubi
Noga Tubi
  • Updated
Set up Hibob integration and get all the insights in Torii's dashboard

Overview

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

Torii supports multiple Hibob accounts.

Please note: Hibob will be removing support for authentication via admin user for API calls on March 31st of 2024. Currently, the integration will continue to support previous connections via admin user (until no longer supported by Hibob), as well as connection via service user (which will be the only supported method going forward). The integration connection guide has been updated to only include instructions for connection via service user.

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:
    Screenshot 2023-09-05 at 12.50.08.png
  • 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.
    Untitled (49).png
  2. Connect to Hibob.
  3. In Connect Hibob, enter the Access Token and the Service User ID
  4. Click Connect.
    Screenshot 2023-09-26 at 14.12.04.png
  5. The "Test Connection" window will make the connection test. Note that the test might take about 30 seconds.
    Click Connect to continue.
    mceclip1.png
  6. Once the integration is connected and synced, it will display a green checkbox.
    Untitled (50).png

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
    Untitled (51).png

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

 

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request