Re-authorising your integration to iPayroll

If you've been disconnected, learn how to get re-authorised

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

  1. In MyHR, head to the account menu by selecting your name in the top left, select 'Manage integrations'
  2. Find the integration with the status: Failed auth
  3. Make sure you are logged out of iPayroll - if you have access to multiple accounts, you can end up connected to the wrong account.
  4. Select the button Authorise MyHR to access my iPayroll
  5. 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.
  6. 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!
  7. 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.