Improved validation for Xero bank feed account mapping
We are improving how Xero bank feed accounts are mapped to prevent the same Xero bank account being connected under more than one companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources. that shares the same Xero application.
What's new?β
Today it's possible to create a duplicate mapping where the target Xero bank account is already connected to a different companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources. using the same Xero application. When that happens, multiple source accounts across different companies point to the same Xero bank feed, making it unclear which is the true source of data.
This update introduces two improvements:
- Validation: when a target Xero bank account is already connected under a different companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources., the mapping request now returns a clear
400error with a suggested resolution, instead of silently creating a duplicate. - Filtered options: target Xero bank accounts already connected to a bank feed under any companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources. using the same Xero app are excluded from the available mapping options.
If a source account is already mapped to a Xero target account, attempting to create the same mapping again still succeeds without errors. That behaviour is unchanged. Existing mappings are not modified.
When does this take effect?β
This update takes effect on 24 June 2026.
Xero APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. limitationβ
Xero's APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. only shows feed connectionsConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. that share the same OAuth application. If a target account is already connected through a different Xero OAuth application, it still appears as available. The mapping attempt then fails with an error explaining that the account is already in use.
Who is this relevant for?β
This change is relevant for Xero bank feedsBank Feeds A Codat product that enables automatic synchronization of bank transaction data into a company's accounting software. clients whose setup meets all of the following:
- Multiple companies share the same Xero OAuth application.
- Those companies connect to the same Xero organization.
- A user tries to map a source account to a Xero target account already used by a different companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources..
How to get started?β
No changes to your integration are required. Once the update is live, you will see:
- Target accounts already connected under another companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources. using the same Xero application no longer appear in the available mapping options.
- Target accounts connected through a different Xero application still appear, but attempts to map them return an error.
Remapping a Xero bank accountβ
If a customer needs to remap a Xero bank account:
- Remove the existing bank feed connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. that uses the account. This makes the target account available again.
- Create a new mapping to the required companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources..
Contact Codat Support or your Account Manager if you'd like help with this change.
