Troubleshooting Xero integration

If you run into issues or errors when setting up Xero, here are some recommendations and troubleshooting tips you can try. 

🛠 Common Xero Integration Error Messages & Fixes

❌ “invalid_grant”

When it happens: After completing all the steps in the article.
Recommendation: This is likely an issue with the Xero server. Try following the authorization link again — this usually resolves it.

❌ “invalid_client”

When it happens: After finishing the setup steps.
Recommendation: This usually refers to an issue with the client ID or secret. Delete the old ID/secret and copy the updated ones into Configuration > External Account Settings.

❌ 403 Authentication Error

When it happens: During the setup of the Xero integration.
Recommendation: Retry the authentication steps, then recreate the Xero connection from the beginning.

🔄 Reauthentication due to broken connection

When it happens: If the connection breaks.
Recommendation: Follow both the create and setup procedures in this article to reauthenticate.

❌ “500 Error” in External Account Settings

When it happens: Clicking a link from External Account Settings.
Recommendation: For clients not live yet, ensure you’re using the correct domain format, like .marketplacer.com.

❌ Validation error email from Xero

When it happens: When pushing remittances to Xero.
Recommendation:

• Make sure the Account Code is entered under:
  Configuration > External Account Settings > Xero Settings

• Ensure the Account Code is valid in Xero and is linked to an account type like ‘expense’ — not sales/revenue.

↺ Multiple Xero Organizations Linked

Question: How can I switch between organizations?
Recommendation: Follow the Xero authorization link again and explicitly grant permissions for the correct account.

✅ Tips

• • Double-check that all credentials are copied exactly (no trailing spaces).

  • Ensure the account you're connecting to has the necessary permissions.