HiBob
Install HiBob integration
The HiBob integration can be found here. Please install it in your environments before proceeding with the steps below.
Set up your HiBob OAuth app
Truto doesn't ship a HiBob OAuth app of its own. Before your end users can connect with OAuth, bring yours:
- HiBob OAuth apps are registered through the HiBob Marketplace partner program. Ask HiBob to register your app with
https://api.truto.one/connect/hibob/callbackas its redirect URL. If you use a redirect URL on your own domain, add that URL instead. - Enter the app's Client ID and Client Secret on the installed HiBob integration. See Overriding OAuth credentials.
Until you add them, the connect UI offers HiBob only through the API Key method.
Connecting a HiBob account
-
Click on Connect Account

-
Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on Get connection link

-
A new link will be generated. Clicking on the link will open a new tab with the list of integrations. You can share this link with your customers too, and they will be able to connect their HiBob account.

-
Select HiBob

-
Choose how to connect:
- OAuth 2.0 (offered once you add your HiBob app): log in to HiBob and approve access.
- API Key: enter the ID and Token of a HiBob service user. The steps below create one.
Generating HiBob Token and ID
You need to be an Administrator to follow the steps below
- Login to your HiBob account and click Settings on the sidebar, and then click Integrations under the Account section.

- Search for "service users" and click on Manage.

- Click on New Service User.

- Enter the Service User Name and Display Name. Click Next.

- Copy the ID and Token to be entered into Truto interface later.

- Go to Permission Groups in HiBob and click on Create Group.

- Enter a Group Name and choose Select people by condition in the Group members section. Click on Edit.

- Remove any conditions if present, and select the Service User you created in Step 4 by clicking the Add Specific Employees dropdown. Click Apply and then Click Create.

- You'll be taken to the Group details page. Click Edit permissions and then select all permissions from People and Timeoff category in the Features tab.

- Then move on to People's data tab and click Edit.

- Select all the Lifecycle statuses and click Apply.

- Click Save to save the permission changes.

- Now go back to the Truto Link interface and enter in the ID and Token you copied from step 5.

- You should now see a connection successful message. You can now close this tab.
Go to your Truto account, and you should see the new HiBob integration under Integrated Accounts. Click on the Account ID to view the details and initiate API calls.