PayHero + MyHR integration
How the PayHero integration with MyHR works
What data is sent from MyHR to Payhero
Leave balances and leave requests
Leave is requested in days, not hours
Why leave balances might not decrease immediately after approval
About PayHero
We are very excited to announce our new integration with PayHero.
Aligning with our ‘make it easy’ vision, our latest partnership with PayHero focuses on reducing the level of administration associated with onboarding employees, managing leave requests, and processing leave in payroll.
With this integration, our leave management tool is transformed into a leave application and approval hub, allowing employees with MyHR self service to view their current and correct PayHero leave balances, apply and have leave approved, and then have the relevant leave data sent through to PayHero to allow for a seamless pay run to be processed.
What the integration does
Connecting MyHR to PayHero means employee details and leave flow automatically between the two systems.
New employees are created in PayHero when they sign their agreement in MyHR, leave approved in MyHR is sent straight to PayHero, and employees can see their leave balances without logging in to payroll.
For new employees
New employee records are automatically created in PayHero when:
- A new employee signs their first employment agreement using the e-signature function in MyHR
- A signed copy of the employment agreement is manually uploaded to MyHR
All of the employee's information provided when you added them to MyHR plus anything they have entered before signing, such as their IRD number, bank account details and tax code will then be used to populate as many details as possible in PayHero.
This establishes the link between MyHR and PayHero for the employee’s record.
If you are not comfortable with an automatic link being established, the integration also allows you to choose to manually ‘send’ new employee details from MyHR to PayHero at any time.
For existing employees
For existing employees, the integration process will require the link between both MyHR and PayHero to be established manually.
MyHR can assist you with the integration process.
What data is sent from MyHR to Payhero
When a new employee is created, MyHR sends the following to PayHero:
- Name, email, phone
- Date of birth, gender
- Address
- Job title
- Start and end date
- Employment type
- Hours of work and pay frequency
- Pay rate and pay type (salary or hourly)
- Tax code and IRD number
- Bank account
- Emergency contact details
Ongoing, MyHR sends approved leave requests to PayHero and pulls leave balances back for employees to see in MyHR.
For ongoing employee detail updates, see Automatic data updates between MyHR and payrolls.
Connecting your integration
Before you start
You'll need:
- In MyHR: Owner access, or Manager access with the Manage integrations permission
- In PayHero: Your PayHero API key — found in PayHero under Settings > Integrations
Step 1 — Open integrations
- Select the Settings cog (top-right corner)
- Select Settings, then click the Integrations tab
- Find PayHero and select Get started
Step 2 — Enter your API key
- Log in to PayHero and go to Settings > Integrations
- Copy your API key
- Paste it into MyHR and select Connect
Step 3 — Configure your settings
Once connected, configure your integration settings:
- Payroll administrator — who receives integration notifications and error emails
- Automatic employee creation — whether new employees are pushed to PayHero when they sign their agreement
- Automatic data updates (Push Updates) — see Automatic data updates between MyHR and payrolls
- Leave balance visibility — management only or self-service
Linking your people
After connecting, you'll need to link existing employee records between MyHR and PayHero. For a full guide see Navigating integrations in MyHR.
- Select the Settings cog > Settings > Integrations > PayHero > Manage
- In the Manage tab, profiles show with one of these statuses:
- Not linked — exists in one system but not connected to the other
- Connected — successfully linked
- Action required — data issue or sync error needs attention
- Excluded — manually excluded from the integration
- Select the ellipsis menu (..) next to a profile and choose 'Link to an existing payroll profile' or 'Link to an existing MyHR person'
- Select 'View details' to review a side-by-side comparison before confirming
Once a link is established, MyHR checks for any pending or future approved leave. If found, those leave entries need to be mapped to a payroll leave type before the leave sync activates.
When MyHR creates a new employee in PayHero, PayHero assigns a work pattern automatically. Payroll admins should review and configure the work pattern in PayHero after the employee is created.
Automatic data updates
MyHR can automatically push employee detail changes to PayHero. Turn on Push Updates in your integration settings.
See Automatic data updates between MyHR and payrolls for setup instructions and a full list of what gets sent.
Leave balances and leave requests
Once employees are linked, leave approved in MyHR is sent to PayHero automatically.
Always approve leave in MyHR, not directly in PayHero. Leave created directly in PayHero won't appear in MyHR — there's no linked ID to connect the two records.
Leave is requested in days, not hours
Unlike iPayroll and CloudPayroll, PayHero uses days for leave requests:
- Single-day requests: full day (1.0), or fractions — 0.75, 0.5, or 0.25
- Multi-day requests: whole days only
- Exception: employees with the No Regular Days work pattern request Annual Leave in hours
Why the leave balance might not decrease immediately after approval
PayHero doesn't tell MyHR about approved-but-unpaid leave. The balance shown in MyHR does not decrease when leave is approved — it only updates once the employee is paid. This is a PayHero API limitation, not a bug.
To force a balance refresh, go to the person's Leave tab in their MyHR profile.
Parental leave
Unlike iPayroll, parental leave is supported via the PayHero API and can be requested through MyHR.
Known limitations
| Limitation | Detail |
|---|---|
| Leave balance not updated on approval | Balance only decreases once the employee is paid — PayHero API limitation |
| Leave in days not hours | Multi-day requests must be whole days; fractions only for single-day requests |
| Work pattern auto-assigned | PayHero assigns a work pattern on employee creation — payroll admin should review |
| Multiple pay rates | Only the first/main rate updates via automatic push |
| Email address (ongoing push) | Not yet included in automatic pushes — coming soon |
Support
See Payroll integrations — FAQs and Troubleshooting for common issues.
If you need more help, our HR teams are always here for you!
If you have questions, message the MyHR team via the Ask Us chat feature or call us on:
NZ - 0800 69 47 69 (0800 MY HR NZ) or +64 9 887 3345
AU - 02 7908 2240
CA - 1 855 694 7224