HiBob to Employment Hero (formerly KeyPay) two-way integration FAQs
HiBob to Employment Hero Payroll integration FAQs
This document addresses the variety of questions we encounter while helping clients. If you have a question that’s not addressed here, please write to us at support@syncezy.com
About the HiBob to Employment Hero Payroll integration
Workflows and how to guide are located here.
How often does the sync run?
The Employee’s sync runs automatically every 30 mins and extracts data from HiBob and syncs it to Employment Hero Payroll. You also have an option to sync instantly from the integration portal.
The Leave / Time off request runs automatically between 8 pm and 9 pm AEST and extracts data from HiBob and syncs it to Employment Hero Payroll. You also have an option to sync instantly from the integration portal.
Can it be synced instantly?
We have an option for a manual instant sync in the integration portal, from the apps menu, the integration administrator can run instant sync and refresh the data between the regular 30 minute syncs.
A typical use case might be: A new employee has been added in HiBob that needs to have payroll set up asap.
What records can be extracted from HiBob?
Anything that is supported by the HiBob API can be extracted, and we are constantly adding to this list. If you have any special requirements that are not covered reach out to us at support@syncezy.com
As of the current time, the following data from HiBob is extracted into Employment Hero Payroll:
- HiBob Employee Fields
- HiBob Leave Types
- HiBob Employee Leave Requests
Is there anything that needs to be set up in Employment Hero Payroll first?
- Business setup and details
- Pay Category names need to match the Salary Pay Type in HiBob
- Primary Locations matching to a field such as Site’s in HiBob
- Leave Categories with correct hourly or daily time frame
What fields does an employee need to have in HiBob for it to sync/create employees in Employment Hero Payroll - Incomplete
To create an incomplete employee record in Employment Hero Payroll, the minimum fields for the an employee to be created are
- First name
- Last Name
- TaxCode or TFN - Tax File Number - Under the Payroll section
- Critical - This TFN must be correct, as Employment Hero Payroll does a check to verify this on creation / update of that field
- If these fields are not used, or correct in the TFN case, the employee will not be created or updated.
- Start Date
- Employment Section
- Employment Contract - FTE
What fields does an employee need to have in HiBob for it to sync/create employees in Employment Hero Payroll - Complete
To make an employee a Complete record in Employment Hero Payroll, The minimum fields for the an employee to be created are
The above minimum fields
- Date of Birth
- Email address
- Residential Address
- Postal Address
- Salary Pay Schedule
- Pay Run Defaults including Pay Category, Pay Cycle and Location
- Primary Location
- Bank Accounts inclusive of:
- Bank Account Name
- Bank Account Number
- Bank Account BSB
- Bank Account Percent Of Allocation
A full and comprehensive list of the exact field pairings, can be found here.
What happens if there is an error with the sync?
On setup of the integration on our SyncEzy portal, the admin user has the ability to set up a notification email address to alert if there are any errors.
How far back can the integration sync leave requests?
The integration syncs leave requests that have been added or modified within the last 30 days, along with all future leave requests. Leave requests that have not been updated within the last 30 days are not included in the initial sync.
Need to sync an older leave request? You can make a minor update to the leave request, such as adding a note or making a small change to the existing notes. This will update its modification date, allowing it to fall within the 30-day sync window.
If you need assistance syncing leave requests that fall outside this 30-day window, please reach out to our team.
What happens when employee details change?
When an employee's details are updated, for example, changed employee ID email, leave requests etc, the details are flagged by HiBob and the sync can extract this data and send it over to Employment Hero Payroll.
The SyncEzy integration will only reflect what is currently up to date and added to the employee record in HiBob.
So if:
- Any data updated on a record in HiBob will sync over and update to Employment Hero Payroll, provided those fields are paired in your SyncEzy integration account
- If a HiBob User or Employee via Self Service edits an existing employee or their own record, it will update that existing employee in Employment Hero Payroll
- If the HR staff member adds a new employee it will set up a new contact record in Employment Hero Payroll
- You will only ever see the correct and current data on an employee in Employment Hero Payroll that exists on that employee in HiBob
- If the HR staff member sets an employee status to “terminated” it will send an email for the user to be archived in Employment Hero Payroll
If I update information in Employment Hero Payroll, does it sync back into HiBob?
At this stage, the integration is a one-way sync only (HiBob to Employment Hero Payroll).
Need some help connecting my HiBob account and Employment Hero Payroll?
We offer customers onboarding and set up as a part of our services, please reach out to us at support@syncezy.com one of our team members will be happy to book a setup session.
What access do I need to get the integration started?
For HiBob, the user setting up the integration will need access to the integration api key from the user menu, and the ability to create a service user to allow access to the API. Once that user account is created, an administrative rights user must add the newly created service user to the “Admin Service User” Group in HiBob. Information can be found here:
How many employees can be synced? Are there any limits?
There is no limit to the number of employees that can be extracted. If the number of employees is more than a few thousand, the initial download can take up to 20 mins for around 250 employees.
Once the initial sync is complete, the system keeps Employment Hero Payroll in sync with HiBob, every 30 mins. So future updates should be pretty instant. Future updates for 250 employees will take around 1-2 mins
Where do I go to check the settings and billing details on my Employment Hero Payroll integration?
You can view your settings/configurations and billing details by logging in to the SyncEzy integration portal.
Select the Plan Details menu to view your plan interval and cost. All other menus will relate to settings, use and management of the integration itself.
Can I change the Employment Hero Payroll account?
Yes, login to your SyncEzy account at integrations.syncezy.com.
Go to My Integrations, select the Details button next to the integration you’d like to edit and select “Reset Credentials” from the left menu. This will reset your credentials on both sides and you can reconnect the HiBob and Employment Hero Payroll to a different account.
Can I customise what is sent over from HiBob to Employment Hero Payroll?
Apart from the Employee, Leave Type and the prebuilt Field Value Paring, at this stage you can’t customise what is sent over to Employment Hero Payroll. When you fetch employee information into the SyncEzy integration portal to send to Employment Hero Payroll, we fetch information from the currently connected fields only.
Other questions
Have a support question?
We offer three support channels:
Chat - Live Chat (AEST Business hours) from the bottom right corner within your integration portal account.
Phone - Press # 1 for Support:
AUS: +61 2 9136 9448
NZ: +64 9 303 2999
UK: +44 203 670 1109
US: +1 720 500 9302
Email - support@syncezy.com
Have you done this before and what about the security of data?
Yes, we have. We have been building integrations for the last eight years with over 50 integrations built across various software systems. All of our communication between software systems is fully encrypted.