Mapping Xero contacts to clients without creating duplicates
Connect Xero to Finye without flooding your directory with duplicate clients. A practical guide to matching contacts, entity types and merge decisions.
The first time you connect Xero to a new practice management system, the result is rarely tidy. Xero might hold a few hundred contacts, but plenty of them are not really clients at all, and some clients appear two or three times under slightly different names. Sync everything blindly and you inherit that mess permanently. The good news is that a little planning at connection time keeps your Finye directory clean from day one.
This guide walks through how Finye matches Xero contacts to the right client record, how entity types factor in, and the merge decisions that prevent a cluttered directory.
Why Xero contacts and Finye clients are not the same thing
In Xero, a contact is anyone you raise an invoice for or pay money to. That bucket includes your actual accounting and bookkeeping clients, but it also includes suppliers, your landlord, software vendors, the ATO and one-off payees. A Finye client is narrower and more structured: it is an organisation or an individual you provide services to, with a defined entity type such as company, trust, partnership, sole trader or SMSF, and a set of contacts attached to it.
Because of that mismatch, a one-to-one import is the wrong mental model. You are not copying Xero contacts into Finye; you are deciding which Xero contacts represent real clients, and which Finye client record each one belongs to. Treating the sync as a mapping exercise rather than a bulk copy is what keeps duplicates out.
Decide what should become a client before you sync
The cleanest connections start with a short review in Xero itself. Before you turn on two-way sync, spend twenty minutes pruning and labelling so the data crossing the bridge is already the data you want.
- Separate clients from suppliers. If a contact is only ever a supplier or expense payee, it should not become a Finye client. Many practices use Xero contact groups to tag who is genuinely a client, which makes the first sync far easier to filter.
- Spot the obvious duplicates. A business that appears as both "Smith Holdings" and "Smith Holdings Pty Ltd" needs to be reconciled in Xero first, or flagged so you merge it on the Finye side. Fixing it once at the source saves cleaning it up in two systems later.
- Check the legal name. Xero contacts are often saved under a trading name or a person's first name. Finye client records work best with the full legal entity name, so note where the two differ.
Doing this groundwork means the contacts arriving in Finye already resemble a client list, not a payables ledger. If you are still weighing up whether Finye fits your practice, our guides walk through the wider onboarding process.
How Finye matches Xero contacts to client records
When you connect Xero, Finye does not silently create a record for every contact. It looks for the strongest available signals that a Xero contact already matches an existing Finye client, so you confirm matches rather than rebuild your directory.
The most reliable signal is a previously linked record. Once a Finye client has been connected to a Xero contact, the two-way sync keeps them paired, so future changes flow to the existing record instead of spawning a new one. For first-time connections, name and email are the practical matching points. An exact business name or a shared primary email address is a strong indication that the Xero contact and a Finye client are the same entity.
Where Finye is less certain, it is better for it to ask than to guess. A near-match, such as a slightly different spelling or a trading name versus a legal name, is exactly the situation that produces duplicates if auto-created. Review these candidates yourself and either link the Xero contact to the right existing client or confirm it as a genuinely new one.
Get the entity type right, because it shapes everything downstream
Entity type is not just a label. In Finye a company, trust, partnership, sole trader and SMSF each carry different compliance obligations, and the compliance engine uses that classification to track the right lodgment deadlines, from BAS and IAS through to income tax returns and ASIC reviews.
Xero will not tell you the entity type cleanly. A contact called "The Jones Family Trust" is obviously a trust, but "J & M Jones" could be a partnership, a sole trader or simply two individuals. As you confirm each match, set the entity type deliberately. Getting this right at mapping time means:
- Compliance due dates are generated against the correct entity from the start.
- Contacts attach to the proper parent client rather than floating as standalone records.
- Individuals connected to a business, such as directors or trustees, are recorded as contacts on that client rather than as separate clients in their own right.
That last point matters most for duplicate prevention. A common cause of a messy directory is importing both the company and its director as two top-level clients. In Finye, the director is usually a contact on the company record, not a client of their own.
Make merge decisions deliberately, not in bulk
Even with careful prep, you will hit cases where two records clearly describe the same client. Handle these as conscious merge decisions rather than leaving both in place "for now". When you merge, keep the record with the correct legal name and entity type, then fold the other one's contacts, email addresses and history into it.
A few principles keep merges safe:
- Merge towards the structured record. If one record has the right entity type and attached contacts, make that the survivor and bring the looser record's details across.
- Preserve the Xero link. Make sure the surviving Finye client stays connected to the Xero contact so two-way sync continues without re-creating anything.
- Resolve duplicates before turning on recurring work. Templated recurring jobs and engagement letters reference the client record, so it is far cleaner to merge first and then build automation on a single, correct entity.
Once your directory is reconciled, the two-way sync becomes an asset rather than a liability: updates to a client's details in Finye or Xero stay aligned, and new contacts no longer arrive as mystery duplicates.
Start with a clean directory
A practice management system is only as good as the client list underneath it. By pruning suppliers, confirming matches, setting entity types deliberately and merging with intent, you turn a noisy Xero export into a directory you can actually run a practice on. Finye is built to support exactly that kind of careful onboarding rather than a blind bulk import.
Ready to connect Xero the clean way? Create your Finye account to start mapping your contacts, or review the pricing to find the right plan for your practice.