# HiBob

> Source: https://truto.one/docs/integration-guides/hibob/

## Install HiBob integration

The HiBob integration can be found [here](https://app.truto.one/integrations/available/ba8ff697-f340-4dad-9bff-370b039f551f). Please install it in your environments before proceeding with the steps below.

## Connecting a HiBob account

1. Click on **Connect Account**
   ![Click connect account](https://docs-assets.truto.one/truto-connect-account.png)

2. Type in a value for the Tenant ID. This can be any ID of your choosing. And then click on **Get connection link**
   ![Get connection link](https://docs-assets.truto.one/truto-connect-account-modal.png)

3. 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.
   ![Share connection link](https://docs-assets.truto.one/truto-connect-account-link.png)

4. Select HiBob
   ![Select HiBob](https://docs-assets.truto.one/select-hibob.png)

5. You'll now be asked for your HiBob API Token and ID.

## Generating HiBob Token and ID

:::callout{type="warning"}
You need to be an Administrator to follow the steps below
:::

1. Login to your HiBob account and click **Settings** on the sidebar, and then click **Integrations** under the **Account** section. ![HiBob integrations](https://docs-assets.truto.one/hibob-integrations.png)
2. Search for "service users" and click on **Manage**. ![HiBob service users](https://docs-assets.truto.one/hibob-service-user.png)
3. Click on **New Service User**. ![HiBob new service user](https://docs-assets.truto.one/hibob-new-service-user.png)
4. Enter the Service User Name and Display Name. Click **Next**. ![HiBob service user details](https://docs-assets.truto.one/hibob-service-user-details.png)
5. Copy the ID and Token to be entered into Truto interface later. ![HiBob service user id and token](https://docs-assets.truto.one/hibob-service-user-credentials.png)
6. Go to [Permission Groups](https://app.hibob.com/settings/permissions) in HiBob and click on **Create Group**. ![HiBob permission groups](https://docs-assets.truto.one/hibob-create-permission-group.png)
7. Enter a **Group Name** and choose **Select people by condition** in the Group members section. Click on **Edit**. ![HiBob create permission group](https://docs-assets.truto.one/hibob-permission-group-details.png)
8. 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**. ![HiBob permission group members](https://docs-assets.truto.one/hibob-permission-group-add-member-2.png)
9. 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. ![HiBob permission group permissions](https://docs-assets.truto.one/hibob-permissions-people.png) ![HiBob permission group permissions timeoff](https://docs-assets.truto.one/hibob-permissions-timeoff.png)
10. Then move on to **People's data** tab and click **Edit**. ![HiBob permission group people data](https://docs-assets.truto.one/hibob-permission-people-data.png)
11. Select all the **Lifecycle statuses** and click **Apply**. ![HiBob permission group people data lifecycle statuses](https://docs-assets.truto.one/hibob-permission-people-data-add.png)
12. Click **Save** to save the permission changes. ![HiBob permission group people data lifecycle statuses](https://docs-assets.truto.one/hibob-permission-save.png)
13. Now go back to the Truto Link interface and enter in the ID and Token you copied from step 5. ![HiBob enter id and token](https://docs-assets.truto.one/hibob-enter-id-token.png)
14. _Voila!_ 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.