HiBob integration
Rebecca Russell avatar
Written by Rebecca Russell
Updated over a week ago

Our HiBob integration automatically syncs your employee information from HiBob to PayFit, significantly reducing the time spent entering employee changes.

Note: PayFit has recently transitioned to using a service user ID and token to authenticate the link to your Hibob data.

If you notice employee data missing from your daily sync, please ensure your service user has been set up correctly. For further details on how to set up your service user, please refer to this Help Centre article.

If you've already set up your service user, please refer to the FAQ section below for reasons why you're missing employee data.

Benefits of using the HiBob x PayFit integration

By using our integration with HiBob, you can:

πŸ’‘ Save time.

πŸ’‘ Remove manual double entry of data.

πŸ’‘ Improve workflows and alignment between HR and finance teams.

πŸ’‘Choose the data you'd like to be synced with PayFit

πŸ’‘ Align your tech stack.

What information can be synced from HiBob?

Once you've set up the integration to PayFit, you can choose to sync any of the following fields from HiBob.

Note: HiBob is the source of truth. Information is synced from HiBob to PayFit, not the other way around.

The integration can sync any of the following information that has been added, removed or changed:

βœ… Personal information: name, address, phone number, email address.

βœ… Employee bank details: sort code, account number, and bank name (UK bank details only).

βœ… New starter personal information: including gender, title, tax code, NI number, payroll number, and start date.

βœ… Salary changes: hourly, daily, weekly, monthly & yearly salaries (backdated up to one month in the past).

βœ… Contract details: job title, hours worked per week, weekly working pattern.

βœ… Leaver information: leave date, reason.

βœ… Bonuses or commissions.

βœ… Annual and sick leaves: start and end dates in the current month, the future or up to one month in the past.

❌ Annual leave entitlement (this must be added manually into PayFit if you want the remaining leave entitlement to be calculated and for PILOH to be calculated when an employee leaves).

❌ Change of employment start date (this is to avoid discrepancies with HMRC).

❌ Other types of leave (eg. parental/unpaid/jury service).

❌ Other types of payments (incl. deductions).

❌ Pushing payslips from PayFit to HiBob.

❌ Overtime.

❌ Pension scheme information.

❌ Custom fields - We don't currently support synchronisation for custom fields. PayFit can only sync the default HiBob fields. It's also important that these fields aren't renamed in HiBob as this can disrupt the sync.

Overview of steps to set up the integration

There are five steps to setting up the integration between HiBob and PayFit.

  1. Set up your Service User in HiBob.

  2. Service User ID and Service User token into PayFit.

  3. Decide which employees to sync.

  4. Choose which fields to sync.

  5. Contact us to arrange testing.

Section one: Set up your Service User in Hibob

For PayFit to access information from HiBob, we use a Service User ID and token. These allow PayFit to access your HiBob data. To create the Service User on Hibob, please refer to our Help Centre article.

Section two: Enter your Service User ID and token in PayFit

  1. From the left, choose Integration Hub, then next to HiBob, click Activate.

  2. Tick the box to certify that you're authorised by your company to activate the integration, then click Grant access.

  3. Under the All integrations section, click HiBob.

  4. Click Actions, then Configure.

  5. Click Service user information.

  6. Read and accept the security statement.

  7. Paste the Service User ID and token you copied earlier from HiBob.

  8. Enter an email address to receive updates from PayFit related to your integration.

  9. Finally, click Save.

Section three: Choose which employees to sync

At this point, you need to note which employees you'd like to sync, so you can send this to us:

Tip: We'll set this up for you as part of our testing. Please don't add these details yourself just yet.

  1. Do you want the integration to add new employees to PayFit: Yes/No

  2. Do you want to sync all of your employees: Yes/No

  3. When do you want to add employees to PayFit?: As soon as they're added to your HR software, or only if their start date is in the current month.

  4. If you chose to sync only some of your employees, note down the Contract type, Departments and Sites that you'd like to sync.

    For example, sync all Part-time or Permanent contract types in the London, Manchester and Newcastle sites.

Section four: Choose which data fields to sync

  1. Click Settings.

  2. Tick the fields you'd like to sync from HiBob, then click Save.

Section five: Contact us to arrange testing

We recommend running a practice sync before syncing into your live account. This gives you a chance to review the information that will be synced from HiBob into PayFit without affecting your live account. To do this:

1️⃣ Send our team a message via the Help Centre to say that you'd like to test the integration. Don't forget to include the settings you noted in Section three.

The testing process usually takes a couple of days. Our Customer Success team will get in touch if there are any issues related to your Service User ID and token.

2️⃣ After the testing is complete, they'll direct you to the integration activity log, stored securely in your Company documents folder. This log shows the employee data that would sync from HiBob, based on the settings provided. Please review this data to make sure it includes the data you expected.

Tip: We can run another test integration if you'd like to change the employees, or the fields to sync.

3️⃣ Once you're happy with the data, you'll need to add those employee settings that you noted in Section three, to PayFit. To do this:

  1. Click Integrations Hub on the left, then the Activated integrations tab.

  2. Click HiBob.

  3. Click Actions, then Configure.

  4. Click Employee sync, enter the details you noted in Section three, then click Save.

4️⃣ The integration is now live and your data will sync from HiBob each night.

FAQs

How often will my HR data sync to PayFit?

Once the integration is set up, the sync happens at night (outside of business hours) every 24 hours. Any information added to HiBob will appear in PayFit the following day.

How can I track the changes made via the integration?

Within the integration hub, you can view a log of the changes made through the integration, with information such as the date of the change, the type of change, and the original and new data available on your PayFit app. To view the activity log:

  1. Click Integrations Hub on the left, then the Activated integrations tab.

  2. Click HiBob.

  3. Click Actions, then Configure.

  4. Finally, click Activity Log.

You can also download the log to review it offline.

What happens if there's an issue?

We have a dedicated team that looks after our integrations. They test and monitor the integration regularly, so if we spot anything that looks amiss, your customer care representative will be in touch to notify you and advise on the next steps.

If you notice a difference in the information synced after the switchover from your API token to Service User ID and Token, there are three possible reasons for this:

No data at all is syncing from Hibob.

This happens if the Permission Group hasn't been set up correctly.

To resolve this, please refer to the Step two: Set up your permissions group in HiBob section in this Help Centre article.

Some employees, or fields for all employees, are not syncing.

This happens if some of the permissions haven't been assigned correctly to your permissions group.

To resolve this, please refer to the Step three: Assign the correct permissions to your permissions group in HiBob section of this Help Centre article.

Some leaves are not syncing or have been removed.

This can happen if you use private policies in HiBob and haven't assigned the correct time-off permissions to your permissions group.

To resolve this, please refer to the Step three: Assign the correct permissions to your permissions group in HiBob section of this Help Centre article, paying particular attention to the Time off Menu options.

Note: Your integration will run again overnight, so you'll need to wait until the following day to see if the issue is resolved.

If your data still doesn't seem to be syncing correctly, please reach out to a member of our team via the Contact Us form.

What if I don't want all HiBob employees to sync to PayFit?

When selecting your integration settings, you can choose whether you want all of your employees on HiBob to be added to PayFit. If you select no, you're able to choose the filters to apply. Once you've selected the filters, you'll need to wait one working day for PayFit to pull over the filters (e.g., if you select contract type, PayFit will copy over the categories you use on HiBob). Once you've selected the specific categories, PayFit will only sync this information.

What causes an authentication error, and how can I fix it?

The most common authentication errors are:

  • The Service User ID or token has a typo, so it needs to be re-entered correctly on PayFit.

  • The Service User ID and token is correct; however, the permissions are not set up correctly. This means that PayFit can't pull the employee data from HiBob unless the permissions are extended on HiBob.

If the authentication error isn't rectified by following the above instructions, please reach out to our team via the Contact Us form.

What happens if I update my employee information on PayFit but not on HiBob?

If you update employee information in PayFit, when the integration runs overnight, the information will be replaced with the information currently in HiBob.

How are employees matched between PayFit and HiBob?

To ensure PayFit updates the correct employees with HiBob information, we use nine data points to match the employee, then check for differences between PayFit and HiBob.

If the employee can't be matched, they'll be indicated as 'Not complete' in the Matched employee details section. If an employee is β€˜Not complete’ this also prompts a required action to ensure that the employee's payroll will run smoothly. Information may need to be updated in HiBob for PayFit to sync the data to the correct employee. More information regarding this can be found in our Employee Matching Status article.

What additional employee information do I need to add for starters?

When you add an employee to HiBob, their information is synced overnight to PayFit, reducing the time taken to onboard your new team members. However, not all employee information needed for payroll will be entered into your HR software. Therefore, for every new starter, there will be some additional information to be added to PayFit, e.g., year-to-date information, to ensure your employee is included on the payroll and paid correctly.

When are starters synced from HiBob to PayFit?

You can now choose when new employees are added to PayFit. The options are: as soon as the employee is added to the HR software (via the overnight sync) or if their start date is in the current month. You can adjust your choice at any time by going to the Integrations Hub > Settings.

What happens when I re-employ an employee in HiBob?

If an employee returns to work for you after leaving, within HiBob, you can simply add a new contract to the existing employee's record. However, from a payroll point of view, HMRC requires a second employment, with a new RTI ID. This requires a second employee record in PayFit.

As the original HiBob record is linked with the employee's first employment on PayFit, PayFit is no longer able to sync information from HiBob to a new record on PayFit. To use the integration for the second employment, in HiBob, you'll need to set up a second employee record for the new employment. Otherwise, this employee will always be excluded from the sync, and you'll need to manually update the record in PayFit and HiBob.

I've purchased Payroll Hub; how do I connect it to PayFit?

PayFit currently integrates directly with HiBob and not Bob’s Payroll Hub, Payroll Connect.

Will more features be added to the HiBob x PayFit integration?

We're always working to improve our integrations, so if you have any suggestions for further information on how to sync from HiBob to PayFit, please let our team know via the Contact Us Form. While we can't promise any specific features due to data access limitations, it's great for us to know what could improve your internal processes even further.

Does the HiBob integration work for PayFit in other countries?

At this time, the integration is only available in the UK.

Did this answer your question?