If you want to temporarily pause your Xero integration, without losing your configuration settings, you can deactivate it from within Unleashed. When deactivated, no updates made to your Customers or Suppliers in Unleashed will sync to Xero and no transactions will export.

When the integration is deactivated, you will still be able to update your Configuration settings but you will not be able to view or use the Manage your Data or Export Data pages.

Once you're ready to continue using the Xero integration, you can reconnect via the integration's page. Just bear in mind that any transactions that have completed or any changes that have been made to your Customer or Supplier records in Unleashed since the integration was deactivated will not automatically export and will need to be manually exported. For more details, see Xero: Export Data.

To reactivate your Xero integration:

Deactivating your Xero integration is particularly useful when updating your configuration settings or making bulk changes to your Customer and Supplier records in Unleashed. Any time a Customer or Supplier record is updated or saved in Unleashed the change is synced to Xero in real time.

By design, Xero has an API limit of 5000 calls per 24 hours, which means Unleashed is only able to export up to 5000 changes (including completed transactions and updated Customers and Suppliers) to Xero per day. If you're therefore updating Customers or Suppliers in Unleashed in bulk, each individual record's update will add to your daily API limit in Xero. We therefore recommend considering deactivating your Xero integration when completing bulk updates to your Customers and Suppliers in Xero, reconnecting once all edits have been made.

There are 3 ways in which the Xero integration's connection can be broken and subsequently stop any further updates from syncing or exporting between Unleashed and Xero:

Each of the above instances can be used to help resolve mapping errors or syncing issues with your current Xero integration. We would always recommend trying to refresh your Xero integration using each of the above options in the order they're listed above.

The Xero integration connection can be broken in three ways, each with different implications for your configuration settings and data. If you're experiencing mapping errors or syncing issues, we recommend working through each option in the order listed below.
​

Turning off the Integration Status toggle in Unleashed pauses all exports and syncs, but preserves your configuration settings and mappings. This is the least disruptive option and is best used for basic troubleshooting or when making bulk updates to Customer or Supplier records. See Why deactivate? below.

Uninstalling the integration removes all configuration settings and mappings and stops all exports and syncs. This is typically reserved for moderate-to-critical issues, such as mapping discrepancies or system errors. Before uninstalling, take note of your current configuration settings, as these will need to be re-entered after reinstalling. For guidance, see Xero Integration Setup.

If Unleashed is removed as a connected app from within Xero itself, the integration will be deactivated on the Unleashed side. An error message will appear in your Xero Connection Log to confirm this has occurred. For details, see Troubleshooting Xero integration errors.

Deactivating the Xero integration is particularly useful when making bulk changes to Customer or Supplier records in Unleashed. Every time a Customer or Supplier record is updated or saved, the change syncs to Xero in real time when Export Customers and Export Suppliers are enabled in your Configuration. Xero enforces an API limit of 5,000 calls per 24 hours. Each individual record update counts toward this limit, so bulk changes can quickly exhaust your daily allowance.

By deactivating the integration before making bulk updates and reconnecting once all edits are complete, you avoid hitting the API limit and ensure your changes sync cleanly.

When you're ready to resume, you can reconnect from the same page. Note that any transactions completed or Customer/Supplier changes made in Unleashed while the integration was deactivated will not sync automatically; these will need to be manually exported. For details, see Xero: Export Data.