This article is for clients and it explains how they can connect their HiBob directory to Deel to onboard their PEO employees.
For other employee types, check out our other articles:
In this article
- High-level workflow
- Before you begin
- Step 1. Connect to HiBob
- Step 2. Create draft agreements
- Step 3. Exclude entities from the sync
- Step 4. Sync employee data
- Reference
High-level workflow
The HiBob integration can sync data from HiBob to Deel.
When you set up the integration, you will:
- Select the employees that you want to sync to Deel.
- When the sync happens, an employee profile and a draft agreement is created for each of them in Deel.
- The employees can complete their agreement signature process in Deel and manage their payslips in Deel.
- All future updates to the employee data in HiBob are synced to Deel. Data only syncs one way from HiBob to Deel.
Before you begin
Before you start following the instructions in the article, make sure to have:
- An understanding of the integration's capabilities and limitations
- An admin role in Deel
- An admin role in HiBob
- HiBob permissions configured
- The service user credentials obtained when configuring the HiBob permissions
- The employees you want to sync have all the required info populated in HiBob
Step 1. Connect to HiBob
1. Go to More > Apps, locate the HiBob app, then click Connect HiBob.
2.Enter the details of the service user and click Continue.
The app is now connected and you can continue to set up the integration.
Step 2. Create draft agreements
After you connected to HiBob, you must create draft agreements so that your data can start syncing. Follow these steps to start syncing your employees:
- From the Plugins tab, locate the PEO area and select the option Mass PEO employee agreement creation.
- On the resulting screen, select the employees you want to sync, then click Create agreements.
Agreements are created as draft with basic employee information, and you are prompted to complete the agreement creation and enter the missing details, among which the entity that the agreement will be created under. Once all required fields are entered, you can submit the agreement. Then the employee will be invited to the Deel platform where they can complete their onboarding.
Step 3. Exclude entities from the sync
After you create the agreements, entity sync is activated automatically if any of the employees belong to them. However, you can manually exclude entities from the sync.
To exclude entities from the sync:
- From the Plugins tab, locate the PEO area and select the option PEO employees data sync.
- On the PEO employee data sync area, in the Entities tab, toggle off the entities you want to exclude from the sync.
Step 4. Sync employee data
When the agreement is created and the employee completes their onboarding, data begins to be automatically synced to Deel once a day. This way, if you make updates to any of the worker info in HiBob, they're automatically synced to Deel. However, you can sync data manually by clicking the Sync HiBob button on the integration page.
Reference
Synced data
The following data is synced from HiBob to Deel. Any other data not mentioned here is not synced.
| Category | Field |
|---|---|
| Demographic | ssn |
| Demographic | dob |
| Demographic | employeeFirstName |
| Demographic | employeeLastName |
| Demographic | workerId |
| Demographic | gender |
| Job data | employeeFirstName |
| Job data | employeeLastName |
| Job data | jobTitle |
| Job data | seniority |
| Job data | department |
| Job data | workLocation |
| Job data | personalEmail |
| Job data | personalPhone |
| Job data |
employeeAddress (city, zip, street, geoCode) |
| Compensation | effectiveDate |
| Compensation | employmentType |
| Compensation | payRate |
| Compensation | payType |
| Compensation | weeklyHours |
| Compensation | changeReason |
| Bank account | accountNumber |
| Bank account | accountType |
| Bank account | bankName |
| Bank account | ACHRoutingNumber |
| Bank account |
bankCountryCode (assumed US) |
| Bank account |
currencyCode (assumed USD) |
| Bank account | fullName |
| Bank account | addressLine1 |
| Bank account |
countryCode (assumed US) |
| Bank account | city |
| Bank account | postal |
| Bank account | provinceState |
Required info
The following information must exist in HiBob for the integration to successfully sync an employee profile:
| Field | Description | Comments |
|---|---|---|
firstName |
Employee’s first name as it appears on legal documents. | |
lastName |
Employee’s last name as it appears on legal documents. | |
personalEmail |
Employee’s personal email address. | At least one email address must be provided, either personalEmail or workEmail. |
workEmail |
Employee’s work email address. | At least one email address must be provided, either personalEmail or workEmail. |
country |
Must be “UNITED STATES” or “USA” (PEO only supports U.S.-based employees). | |
state |
The U.S. state where the employee works. Required for tax and legal purposes. | |
hireDate |
The official start date of employment. | |
payRate |
The employee’s compensation amount (annual salary or hourly rate). | |
payCurrency |
The currency the employee is paid in (typically USD). |
Known limitations
- Terminations aren't synced. Terminating an employee must be done manually both in HiBob and Deel.