Hibob Integration

Article author
Charlotte
  • Updated

Hibob is an HRIS and people management platform that helps dynamic companies bring out the best in their employees. Through this new integration partnership, we’re bringing together two of the best platforms in global HR to streamline and accelerate global expansion for companies of all sizes.

This integration will increase the productivity of HR teams by removing repetitive tasks. The integration will automatically sync new employee or contractor hiring data hire information from Hibob to Remote.  By minimizing manual data entry, the integration also reduces the risk of errors within HR processes and communications that could delay onboarding timelines.  Once the onboarding process is complete in Remote, our integration also allows HR teams to automatically sync changes in active employee information from Hibob to Remote to make sure data is consistent across both systems.

The integration is free for customers using both Remote and Hibob.

Data Transferred

During a new hire's onboarding, the employee or contractors full name, email, start date, job title, address, and supervisor are transferred from Hibob into Remote. Once the employee or contractors onboarding process is complete, changes made to an employee’s details in Hibob will be synced to Remote. The Hibob fields that sync to Remote for active employees and contractors are name, email, job title, address, and supervisor.

Note: When syncing new EOR employees from HiBob to Remote, you need to choose a start date in the future.

Before you get started, you need to ensure you have administrator permissions in Hibob. This is required in order to complete the integration setup. Also please note, if you have changed any of the default section names in Hibob, the integration may not work for you.

This article will cover: 

How to configure your Hibob integration

Create your user ID and token

To add the HiBob integration, you will need to create service credentials on HiBob (user ID and token). Follow the steps below to create your user credentials. If you already have HiBob user credentials, you can skip to step 3 to enter your user credentials now. Please note, if you have changed any of the default section names in HiBob, the following instructions may not be exact for you. For any questions you might have, please reach out to Remote support.

1. Create a Service User and get your user ID and token from HiBob

  • Log in to app.hibob.com with a user that has administrator permissions.
  • In the HiBob Settings page, go to Integrations > Automation > Click on Manage under the Service Users card.
  • Click the New Service User button, and enter a Service User Name and a Display Name (e.g. Remote integration), then click Save.
  • After you click Save, you will see a pop up with your user ID and token. Copy and securely store these credentials in a handy place. DO NOT close the pop up window or abandon the page until you have securely stored your user ID and token.

2. Create a Permission Group and assign the correct permissions

    • Create the permission group and assign the service user you created in step 1 with the following steps:
      • In the HiBob Settings page, go to Account > Permission groups

1.png

  • Click on the Add permission group button. Enter a name for your Permission Group in the Group Name field (e.g. Remote integration), and optionally, add a description for the group.
  • In the Group members section make sure Select people by condition is checked, and click on the Select people button.
  • Under the Add Specific Employees section, click on the dropdown and expand the Service Users group. Check the box next to the Service User you created in step 1 and click the Apply button. Then click on the Apply button on the Select people by condition pop up window.
  • Click on the Create button in the Create Group popup. A message will show indicating 1 person will be added to the group. Click on Confirm to finish creating your permission group.

2.png

  • Add the necessary permissions to the permission group by following these steps. This will allow the service user to retrieve all of the necessary employee data for the integration.
    • When you finish creating the group in the previous section, you should be able to see a list of permissions that this group has. If it doesn’t show up or you navigated out of the page, please go back to the list of permission groups by going to the Account > Permission groups page and clicking on your newly created permission group. You should be able to see your group name on the left side, and the list of permissions it has on the right side.

3.png

  • Click on the Edit permissions link on top of the page. This will allow you to enable or disable permissions for this group. You will find a list of the necessary fields for this integration below
    • Under the Features tab check the following boxes:
      • Settings > Employee Fields > Select Manage Employee Field Settings

4.png

People > Lists > Select Edit all lists (sites, job titles, etc.)

5.png

Under the People’s data tab, choose the People group and ensure the following items are checked. Please note that some of the items are selected by default, which will show as a light gray checkmark.

6.png

    • Within the following sections, ensure there is a gray checkmark next to each item:
      1. About > View selected employees’ About sections
      2. Address > View selected employees' Address sections
      3. Basic Info > View selected employees' Basic info sections
      4. Employment > View selected employees' Employment sections
      5. Employment > View selected employees' Employment section histories
      6. Home > View selected employees' Home sections
      7. Identification > View selected employees' Identification sections
      8. Personal > View selected employees' Personal sections
      9. Personal Contact Details > View selected employees' Personal contact details sections
      10. User Data > View selected employees' User data sections
      11. Work > View selected employees' Work sections
      12. Work Contact Details > View selected employees' Work contact details sections

Under the People’s data tab, click on the Access rights button on top of the list. Click on the Edit button and within the popup, select Lifecycle Status from the first drop down. Select exists from the second dropdown. Click Apply.

7.png

Finally, click on the Save button on top of the page. A message will confirm that you will be adding the permissions to the group. Please take some time to review the permissions you’re adding with the list above. Click on Apply to continue.

8.png

Enter your user credentials

      1. You will need to log into your Remote account. Once you're in your Remote account, go to the Integrations tab and click on Add from the Hibob integration card.
      2. In the Add the Hibob integration section, you’ll select Add integration. Or you can click the Add Hibob integration button in the top right corner of the page.
      3. Enter the user credentials copied in step 2 into your Remote account. Then click the continue button.

9.png

How to sync employee information

Now that your Hibob integration has been added, you can set up your accounts to sync employee information from Hibob to Remote. To do this:

  1. In the Hibob People tab, go to Directory. Select the employee you want to sync with Remote.
  2. On the employee's profile, scroll down to the Work section and click on the edit button on the top right corner of the section.
  3. In the Sync to Remote field, select either As employee or As contractor or As global payroll employee, then click Done.
  4. Repeat this step for all the employees you would like to sync to Remote.

Now, you can manually sync those profiles from Hibob to Remote. Click the Manual sync button within Remote to manually force updates to sync in Remote. That’s it! You successfully added the Hibob integration and synced Hibob profiles.

Please note that once set up, the integration automatically syncs all selected employees’ data regularly. If your changes have not synced in Remote after having completed the integration setup, you can use the manual sync button in Remote or wait a few minutes and then try reloading the screen.

You can find the profiles of synced team members in the People tab of your Hibob Integration page in Remote.

Screenshot 2024-06-06 at 6.21.59 PM.png

How to import a new or existing employee or contractor from Hibob into Remote

When the integration is set up, we automatically create a custom field Sync to Remote in HiBob that will be used to identify which users to sync and how. The options are:

  • As employee - for EOR
  • As contractor - for contractors
  • As global payroll employee - for Global Payroll

Please make sure to all users you want to sync have the right value for the custom field Sync to Remote. Here’s how you can do it:

  1. Log into Hibob with a user that has administration permissions.
  2. In the Hibob People tab, go to Directory. Select the employee you want to sync with Remote.
  3. On the employee's profile, scroll down to the Work section and click on the edit button on the top right corner of the section.
  4. In the Sync to Remote field, select either As employee, As contractor or As global payroll employee, then click Done.
  5. Repeat this step for all the employees you would like to sync to Remote.
  6. Now, log into your Remote account. Once you're in your Remote account, select the Integrations option from the left sidebar and click on the Hibob card. 
  7. On the next page, click the Manual sync button to manually force updates to sync in Remote. 

Note: When new employees are added, their full name, email, start date, job title, address, and supervisor is transferred from HiBob into Remote. When existing employees are synced, their name, email, job title, address, and supervisor are synced from HiBob to Remote. 

Check that the start date for new EOR employees has been set to the future in HiBob. Start dates for Global Payroll employees or for active EOR employees can be any time.

How to disable the integration

If you decide to disable the Hibob integration, it is possible to do so from Remote. To disable the integration:

  1. Go to the Integrations tab in Remote and select the Hibob integration card.
  2. From the Delete integration section, select Delete if you wish to disable your Hibob connection with Remote.
  3. From the pop-up, select Delete integration to confirm your choice.

Screenshot 2024-06-06 at 6.22.35 PM.png

Troubleshooting/FAQs

  • Is there a way to connect multiple existing employees already in both HiBob and Remote at once (in bulk) so that their information syncs and stays up to date?
    • For now, you must identify the employees that you want to sync across platforms individually.
  • I followed all the setup instructions but none of my employees are syncing to Remote. What should I do?
    • If none of your employees are syncing, it suggests an issue with the configuration for the Permission Group. Please double check that
      • All required permissions are included in the Permissions Group
      • The correct service user is added to the created Permission Group.
    • Section names were changed: If certain section names shown in an employee’s profile have been changed from the defaults, then our integration won’t work. You will need to set the section names back to the defaults for the integration to work. The sections that must exist are “Work,” “Basic Info” and “Address.” 
  • Some of my employees are not syncing to Remote. What should I do? 
    • Check that all users you want to sync have the right value for "Sync to Remote" field ("Employee", "Contractor", or "Global payroll employee"). This is how we know which users to sync for each use case.
      • Go to the “Work” section of employee profile in HiBob and check that the “Sync to Remote” field has the right value. 
      • If you do not see “Sync to Remote” field at all, please refresh the page. This is a known issue with Hibob: The field will not show up after you have set up the integration until the page has been refreshed.
    • The start date must be in the future. Our rules around start dates for EOR employees are explained in detail below (For Global Payroll employees start dates can be any time.)
      • For completely new employments in Remote: If no employee with the given email is present in our system (i.e. we’re going to create a new employee in Remote), start date needs to be in the future.

      • For existing employments in Remote: If the employment of the employee in Remote is in created status (i.e. the employee is in Remote, but hasn’t onboarded yet), start date needs to be in the future.

      • If the employment of the employee in Remote is in active status, start date can be anything (in the past, in the future, and can also be omitted in HiBob). We ignore the start date for active employees as it is not supposed to change.

      • Recommended solution: If you are trying to sync an employee with start date in the past, you should onboard the employee on the Remote platform directly, without importing them via the HRIS integration. Once the employee is in active status in Remote, you can then successfully sync any updates to their employee data using the HRIS integration.
    • Email addresses: We match records in HiBob and Remote based on work and private emails.
      • If the user already exists in Remote when you are trying to set up the sync, we need the email addresses to match exactly so we know which existing user to update data for. To make this user sync, the data must be changed so that the email addresses match. Once the sync has been done once, the data can be changed back to what it was, but that will also change the email address for the user in Remote because email address changes in Hibob will sync to Remote, so this is something to consider.

If you've confirmed all the above is correct and the problem still persists, please reach out to our support team at help@remote.com and send the following screenshots:

  • Screenshots or list showing that employee’s email addresses (work and personal) in both Remote and Hibob.
  • A screenshot of the “Work” section in Hibob for at least one employee whose data should be syncing but isn’t. This screenshot must include the “Sync to Remote” field. The “Work” section can be found in the employee’s profile.

  • Screenshots of the configuration for the Permission Group to which the configured Service User belongs. This can be found in Settings > Roles & Permissions in Hibob. 
    • We need screenshots of all sections for permissions we require
    • Screenshot of the details of Permission group created to check if the correct service user was assigned to the permission group.

       

Was this article helpful?

1 out of 1 found this helpful

Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.