How to Reauthenticate Your Xero Connection in SyncEzy

How to Reauthenticate Your Xero Connection in SyncEzy

If your data sync has stopped or you have received a notification about an authentication error (such as a token expiry), you will need to reauthenticate your Xero account. This is a standard security measure required by Xero to ensure your data remains protected.

Reauthenticating is a simple process that takes just a few minutes. This guide will walk you through the three main phases: disconnecting the broken connection in Xero, resetting it in SyncEzy, and testing the new connection.

Important Prerequisite: Before you begin, ensure you are logging into Xero with an account that has Admin permissions. Standard user accounts cannot authorize or disconnect third-party apps.

Please follow the steps below.
First, we need to clear the old, expired connection directly from your Xero environment.

1. Login to Xero : https://login.xero.com 

2. Click "Apps" from the top right corner just before the profile icon

3. Click "Manage Connected apps"

4. Click Disconnect next to "SyncEzy simPRO Payroll Integration"

5. Click "Disconnect" again when prompted for confirmation


Now that Xero is cleared, you need to reset the configuration on the SyncEzy side and establish a fresh connection.
6. Login to Syncezy portal . Visit https://integrations.syncezy.com/

7. "My Integrations" page will open. Click on "Details" button on your app. 

8. Click "down arrow button" to reveal connection buttons

9. Click "Disconnect" under Xero . 

10. Click "Yes, Reset" when prompted for confirmation

11. Click "Connect" again

12. Enter your Xero credentials to login

13. Choose your organization/tenant if available

14. Click "Allow access" to connect Xero again. 


The final step is to force a sync to ensure the two systems are talking to each other successfully.

15. After successful connection , this will redirect you to "Refresh App data" tab in your SyncEzy app. Click "Sync all Data"

16. Success message will be shown. 

If you successfully complete these steps and see success messages, your integration is fully re-authenticated and will resume running automatically in the background!

If you still encounter a "token expiry" warning, or if the sync fails during Phase 3, double-check that you completed the disconnection steps in Phase 1 using a Xero Admin account. If issues persist, please reach out to the SyncEzy Support team (support@syncezy.com) for further technical assistance.