If you've been disconnected, learn how to get re-authorised
- When you need to re-authorise
- Who can re-authorise
- Setting up an API user
- Re-authorising your MyHR integration
When you need to re-authorise
If your integration goes into a failed authentication state, we'll be in touch to get you up and running again. You'll also have a reminder in MyHR:
iPayroll: Update your credentials
Your credentials are no longer valid. Please re-authorise the integration.
iPayroll has a scheduled outage on Thursday 23 January 2025 from 6pm
iPayroll will be undergoing from 6pm this Thursday 23 January 2025, after which you will need to re-authorise your integration with a new iPayroll user (an API user). iPayroll will be in touch to help you get this in place.
We will be reaching out to you directly with:
- the steps to take to reconnect from Friday 24 January
- help to manage any leave that was approved while the two systems were disconnected.
Apologies for the inconvenience and if you have any questions, please feel free to send us a chat message.
Who can re-authorise
- iPayroll: an API user set up for the integration
- MyHR: any owner or manager with manage integrations permission who has access to the above account
Setting up an API user
- On iPayroll, the main user will need to set up an API user for the MyHR integration
- The main user is the login with the 5 digit username
- contact iPayroll if you don't have access to the main user
- Follow the instructions on iPayroll's knowledgebase, User Access - API User, to set up the user account with API user access, or follow the video instructions below
- Username must be 13 characters long eg. 12345apiusermyhr
- Once the user has been added, the API user should set up their password and set up two-factor authentication (2FA) if needed.
Re-authorising your MyHR integration
- In MyHR, head to the account menu by selecting your name in the top left, select 'Manage integrations'
- Find the integration with the status: Failed auth
- Make sure you are logged out of iPayroll - if you have access to multiple accounts, you can end up connected to the wrong account.
- Select the button Authorise MyHR to access my iPayroll
- You'll be redirected to iPayroll - log in with your API user account. You may be asked to confirm access to new functionality. We periodically update this to deliver new features.
- You'll be redirected back to MyHR and shown the list of people records from MyHR and iPayroll. Check everything looks as expected and you're good to go!
- If needed, confirm with us whether you want any records sent to payroll that may have been missed while the integration authentication was in a failed state using the chat on MyHR.
Possible issues
- When authorising, if you encounter an error advising you that the account has already been authorised by another account, it's best to contact iPayroll.
- If you inadvertently connect to the wrong iPayroll account, please send us a chat message.