This article is for clients and it explains how they can connect their HiBob directory to Deel in just a few clicks for easy onboarding of their Global Payroll employees.
The integration is a one-way sync from HiBob into Deel Global Payroll.
Before you begin:
For EOR employees or Direct Employees (Deel HR only) setup, check out our article on Setting Up The HiBob Integration On Deel For EOR Employees And Direct Employees.
To add Hibob permissions for Global Payroll, check out our article on How to Add Permissions in HiBob for Global Payroll.
In this article:
Preparing your HiBob settings for Global Payroll direct employees
Preparing your HiBob settings
✅ Step 1 - Create sites in HiBob
Site is a standard field in HiBob used primarily for integration with payroll providers so that Deel better understands how the employee is getting paid.
To add a new site, please follow the HiBob instructions here.
✅ Step 2 - Assign sites to direct employees in HiBob
Permissions are needed to edit employee data in HiBob.
Select the Work tab of a direct employee in HiBob and click on the Site field.
Choose the correct corresponding site from the dropdown menu.
Click Add.
Connecting Deel to HiBob
✅ Step 1 - Connect to HiBob
From the Deel home page, select the Hub icon and Apps tab. Search for HiBob and click on connect to initiate integration.
One must be an Org Admin, IT Developer Admin, or Integrations Admin-People to set up this integration.
✅ Step 2 - Enter HiBob credentials and sync information
Your credentials will be used to securely sync your HiBob information. To get the User service ID and Token:
Step 1 - Sign in to HiBob
Step 2 - Select Settings, and under Account, click Integrations
Step 3 - Select the Service Users app in Automations section
Step 4 - Create New Service User to get credentials, or use an existing service user
Step 5 - To Give permissions to this user, go to Settings -> Account -> Permissions groups -> Select a group or create a new one.
Step 6 - The created group needs permissions to:
Edit selected employees’ Personal sections, View selected employees’ Address sections, View selected employees’ Payroll sections and View selected employees’ Lifecycle sections.
To set permissions for this group, check out our article on How to add permissions in HiBob for Global Payroll.
✅ Step 3 - Notifications settings
Enter one or more email addresses to receive notifications from this integration. Notifications will only be sent in case of errors or required actions related to authentication and data syncing.
Plugins
Global Payroll direct employee plugin sync
This plugin will help automate onboarding, amendments, and terminations into Deel for your Global Payroll direct employees.
This process will help to decide which entity group to create or sync Global Payroll contracts for, according to the HiBob site.
Step 1 - Enter the Global Payroll Employee Sync plugin
Step 2 - Select Entity Settings and click Add
Step 3 - Select an entity and select a site
Select a site that matches the entity country. The sites come from HiBob.
Please make sure that the site correctly corresponds to the desired entity that Deel is running payroll from.
Step 4 - Select a group
Step 5 - Click Apply
Once a pay group and entity have been used, they cannot be reused.
Deleting or editing these mappings requires contacting our support group.
Step 6 - Repeat this process for any other desired entities
Direct Employee data sync plugin
This plugin allows to automate Global Payroll employee onboarding, terminations, and contract amendments into Deel.
Deel will create and continually sync Global Payroll contracts once an entity-group-site relationship is created.
To create and sync Global Payroll contracts:
✅ Step 1 - Select the (1) Plugins tab and click (2) Manage next to Global Payroll - Employee data sync
✅ Step 2 - Map an entity, a group, and a HiBob Site.
A HiBob site and group can only be added once.
If there's the need to change the mapped entity, please contact Deel support 24/7 for assistance.
Auto Sync Payslip and End of Year tax documents plugin
This plugin allows clients to sync payslips and end-of-year tax documents for Global Payroll employees to HiBob.
This enables the group to have easy access to these documents on HiBob. Deel will create a folder at the employee level under the documents tab called Deel Document.
Payslips can only be synced starting from the point when the option to Enable payslip syncing is first toggled on.
Payslips and tax documents will sync to HiBob when they are published in Deel. In HiBob, documents will be synced to the People’s docs section under Shared Docs.
To enable this feature:
1. Select the Plugins tab.
2. Click Enable next to Global Payroll - Auto Sync Payslip and End of Year (Tax document).
Global Payroll - Time Off
This plugin makes HiBob the source of worker time-off reporting when using Deel.
To use the time-off plugin, clients will need to authenticate via User Service ID and Token.
This feature is not available to customers authenticated via API Key. If clients have authenticated via API Key, they can re-authenticate by clicking the More button at the top right of the integration and selecting the Re-Authenticate option.
Configuration Steps:
1. Authentication: Authenticate via User Service ID and Token.
2. Re-Authentication (if needed): If authenticated via API Key, click the More button and select Re-Authenticate.
Once configured, any group member working as a Global Payroll direct employee will enter time off into HiBob instead of Deel. This will only apply to direct employees linked to a HiBob profile, which can be confirmed via the Payroll Logs.
Each Deel time-off type must be matched with at least one time-off type from the HRIS to complete the plugin setup.
Global Payroll - One Time Payment
This plugin makes HiBob the source of one-time payments when using Deel.
Once configured, any group member working as a Deel direct employee for your group will enter one-time payments into your HRIS instead of Deel. This can only happen for employees linked to an HRIS profile.
Each Deel one-time payment type needs to be matched with at least one one-time payment type from the HiBob one-time payment type list to complete the setup. OTP type mapping is done by entity and each mapping retrieves only OTP types from the GP report items specific to that entity.
Please note that the OTP sync to Global Payroll only supports the entity's currency as defined in Global Payroll. Please ensure that any Variable Pay or Entitlement you add in HiBob follows the same currency used by the employee’s entity in Deel Global Payroll.
Data mapping
Data mapping is done on a case-by-case basis due to customized, tailored field setups. Currently, only CC can perform this step. Clients should reach out to their Implementation Manager to set up the data mapping.
When the integration is first installed, a default mapping packet is installed. However, this can be customized to meet specific needs.
The Global Payroll sync to support the HiBob Custom Data feature significantly broadens the scope of synchronizable fields, providing clients with access to a wider variety of fields and the ability to seamlessly sync them to Global Payroll.
Syncing data and log report
Once mappings have been completed, clients must sync data by clicking Sync HiBob in the integration. This will run a poll of the HR system and sync details for any employee with a mapped pay group. The last sync time can be seen under the connected status.
Payroll Logs
The Payroll Logs tab will show the log report from the last sync. This report allows clients to easily open a HiBob profile to investigate any issues or open a GP contract (if available) to do the same.
If clients are unsure about any errors, they should contact the support group, which is available 24/7.
Frequently Asked Questions
[ACCORDION] Can Deel be given access only to certain employees?
Yes, access can be limited with the Service User method. To do this, create a service user with the correct permissions. Grant the group of this service user access to only the desired employees. Filtering can be done by name, employment type, or other conditions.
[ACCORDION] What permissions are required on HiBob?
When using Global Payroll plugins for HiBob, the following permissions are required - Edit selected employees’ Personal sections, View selected employees’ Address sections, View selected employees’ Payroll sections and View selected employees’ Lifecycle sections.
[ACCORDION] How are HiBob and Deel user profiles matched?
Matching Deel and HiBob users is critical for the integration because data is synced only for profiles that are matched. The integration matches profiles by checking the user's email address. If the email provided in Deel matches a HiBob profile's email, the two users are linked.
If any users in Deel cannot be located in HiBob, it is usually because a matching profile cannot be found in HiBob. To resolve this issue, ensure that all users in Deel have a corresponding user profile in HiBob, with the same email address stored in Deel.
[ACCORDION] Will One Time Payment sync support multiple currencies for the same entity?
No, the sync to Global Payroll only supports the entity's currency as defined in Global Payroll. Ensure that any Variable Pay or Entitlement added in HiBob follows the same currency used by the employee’s entity in Global Payroll. For instance, if the entity assigned to the user operates in US dollars, the Variable Pay and Entitlements synced from HiBob should also be in US dollars.
[ACCORDION] How often will the integration sync?
The integration will sync daily, at 12 noon GMT.
[ACCORDION] Can workers be managed manually on Deel if HiBob stops working?
Even if a client’s HRIS software stops working, onboarding and offboarding workers is still possible manually on Deel. To manage employee data manually, the sync with the HRIS software must be temporarily disabled.
To disable the sync:
✅ Step 1: From the Deel home page, select the Hub icon and Apps tab to search for HiBob.
✅ Step 2: Within HiBob, find the Global payroll - employee data sync plugin and click on Manage.
✅ Step 3: On the Global payroll employee data sync drawer, select the entity to be used.
✅ Step 4: Click on the ellipses (three dots), select Disable Syncing and confirm the change.
Keep in mind that data syncs from HiBob to Deel. When the sync is enabled, all the data manually entered in Deel will be overwritten by the data in HiBob.
Before re-enabling the sync, make sure:
- To add the worker(s) to HiBob first.
- That the email and employee numbers in both systems match.
[ACCORDION] Will there be notifications of integration issues?
Yes, Deel will send out notifications of integration or global payroll sync issues. Specify an organization manager (or as many emails as needed) email to receive these notifications.
To do this:
✅ Step 1 - Go into the HiBob integration and click on the inverted ellipsis (three dots) next to the Sync Integration button.
✅Step 2 - Select Email notifications settings from the list of options.
✅Step 3 - In the Email notifications settings drawer, click on the Add button to add an email notifications list.