HiBob Integration
Aleksandra avatar
Written by Aleksandra
Updated over a week ago

By setting up the integration between HiBob and YourCampus you will achieve the following:

  • All eligible employees in your HiBob account will be added to YourCampus

  • Any mutations in HiBob (on and off-boarding of employees) will automatically be synced with YourCampus on a daily basis.

Setting up the integration

To set up the integration you will need to complete the following steps, each step is outlined in detail in this article:

  1. Create a Service User login for YourCampus and save the ID and Token.

  2. Add a custom field to HiBob to indicate if an employee is eligible for access to YourCampus.

    1. Optional: bulk update existing employees to set the value of this new field.

  3. Create a custom Permission Group for the YourCampus Service User login.

  4. Share the ID and Token with YourCampus via an encrypted secret sharing service (e.g. 1password, onetimesecret.com).

  5. YourCampus enables the integration.

Step 1: Creating a HiBob Service User

Follow the steps described in this HiBob support article: https://apidocs.hibob.com/docs/api-service-users

Important: store the ID and Token in a secure location, you will not be able to view these details again after clicking done.

Step 2: Adding a YourCampus Custom Field

In some cases not all the employees who are in HiBob need to get access to YourCampus (e.g. due to team location or position). To indicate which employee is eligible for YourCampus, a custom field needs to be added:

  1. From the left menu, select Settings > Company > Employee Fields

  2. In the Work section click on “New Field”

  3. Configure the field with the name “yourcampus_access” (please use all lowercase and no spaces) and set the the type to “List”.

    1. The screenshot below states the incorrect field name without 'access'. Please make sure to use “yourcampus_access”.

  4. Apply it to the appropriate departments, if relevant.

  5. Using the “Manage” button, add 2 options (yes and no) to the List.

Step 2a (optional): Bulk update your employees in HiBob

In order to set the newly added YourCampus field correctly for your employees, you can bulk update employees as follows:

  1. Go to Analytics > Reports > Add New > General Report

  2. In the column picker, select the email field and yourcampus field and export the report

  3. In the exported report, populate the yourcampus field with “yes” and “no”

  4. Go to People > Import and select the “UPDATE EMPLOYEE DETAILS” options

  5. Upload the updated report file with the email address as identifier and the yourcampus field as the field to update:

Step 3: Create a custom Permission Group for the YourCampus Service User login.

There are 2 options to grant permissions to YourCampus:

  1. Use the 'All users permission group' which is the default setting for newly created Service Users (not recommended)

  2. Create a specific YourCampus group that isolates the permissions (recommended).

    1. If you opt to create a YourCampus Permission Group, please follow the steps in this HiBob article: https://help.hibob.com/hc/en-us/articles/4409776408209#get-the-most-out-of-bob-0-0

    2. Make sure to provide View access to the all following HiBob sections:

      1. Basic info

      2. Personal

      3. Work

      4. Employment

      5. Lifecycle

Step 4: Share the ID and Token with YourCampus

Share the ID and Token which you saved in Step 1 with your YourCampus contact person. Please make sure to use an encrypted secret sharing service like 1password or onetimesecret.com.

Step 5: After testing YourCampus will enable the integration and report back to you on the status of the integration.

🚀 Now you are all set!

Optional: Assigning varying budgets

If you would like to vary the YourCampus budget assigned to employees, this can be achieved by adding custom field(s) in HiBob to indicate per employee what the budget is that the employee should receive. Follow the instructions in this article to set this up.

Did this answer your question?