We launched the Accounting Sample!Manage invoices, payments, expenses, and more across multiple connectors.

Search docs

How to connect to HiBob

To create a connection with HiBob, you need to create an API Service User by completing the following steps.

Note: An API service user is a user type in Bob whose sole purpose is to manage APIs in Bob. Multiple service users can be created with unique permissions for each.

A service user stays active regardless of the status of the person who created the service user, unlike user tokens.

Note: Service users are dedicated API users that are used to pull data from or push data to Bob. The service users are detached from any actual employee and have custom permissions that are defined by the admin. These users cannot "log in" to Bob and are used only by the HiBob public API.

Create a new Service User

  1. From the left menu, select Settings > Integrations.

  2. Select Automation.

HiBob Service User: Step 1

  1. Click the Service Users thumbnail.

  2. Enter a unique name and a display name. Click Save.

HiBob Service User: Step 2

  1. The new service user’s ID and token are now displayed - make sure to keep the token in a safe place, you will not be able to access it again.

HiBob Service User: Step 3

  1. Click Done.

Setting access permissions for Service Users

By default, service users are created with no access permissions.

You therefore need to create a specific permissions group for service users and add the service user to that group. To learn more, see Create a custom permissions group.

To edit your group's permissions, Select Settings > Permissions groups. Choose the relevant group > People's data

To access and manage “employees”, select People > Edit Permissions. Make sure to check all checkboxes whose permission you need to grant.

HiBob Service User: Step 5

If you have already created a permissions group for service users, you'll need to add the user to this group.

HiBob Service User: Step 4

From the left menu, navigate to Settings > Permissions groups.

Choose the relevant group > Group actions > Edit details.

Select people by condition > Edit > Add specific employees > Service users > Apply.

Generate your Service Account Token

Use your preferred tool to encode the ID and token to base64 format. (For an encoding tool, you could use https://www.base64encode.org/)

Paste the ID and token in the following format:

ID:Token
and "Click Encode". Encode

Copy the encoded value.

Encoded

Vault Connection Setup

Now that you've created the Service User Token with access to your HiBob data, you can fill out your credentials in Vault.

Paste the value into the Service User Token field in the following format:

Basic<SPACE>encoded value

Example:

Basic U0VSVklDRS03MzY1OkRha3BGNjNSMXFRUGhvaHA5RmZZczhLUVlFR3N4SmhNNXZGQk52ZUw=

⚠️ Make sure to add a space between

Basic
and the encoded value.

Vault Hibob Service User Token

Click Save after completing the form. If the Service User Token is correctly entered, it will validate the connection and show a success message.

Your HiBob account is now connected 🎉.