Skip to content
  • There are no suggestions because the search field is empty.

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.

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, select the settings cog in the top-right, then 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 eg. 1234apiusermyhr. 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, your main iPayroll user can disconnect the integration on iPayroll set up > users.