LOOKING FOR PARTNERS 🤝

We're currently looking for partners and distributors in different regions. If you're interested, please feel free to contact us.

Xero Contacts syncs with Xero Contacts

Sync Contacts Between Xero Accounts

Learn how to sync your Xero contacts using the SyncPenguin platform


Free 14-day trial with full support, no credit card required

Businesses with several Xero organizations, such as subsidiaries, regional entities, franchises or group companies, often work with the same customers and suppliers in each one. Xero keeps contacts separate for every organization, so teams end up re-entering the same details again and again. Over time, addresses, emails and phone numbers drift out of date in some organizations. Invoices and bills can then go to the wrong place, and keeping everything consistent becomes a manual task that nobody has time for.

How SyncPenguin helps

SyncPenguin connects your Xero organizations so contacts stay consistent across all of them automatically. Set up a one-way sync to publish a master customer and supplier list from a head office organization to its subsidiaries, or a two-way sync so updates made in any organization reach the others. With no-code filters you choose exactly which contacts are shared, for example only suppliers, only customers, or contacts with a specific account number. Field mapping and custom rules let you control what gets copied. An initial merge matches the contacts that already exist in each organization, so you get a single, up-to-date contact base across your group without duplicates or repetitive data entry.

Best suited for: Multi-entity and group businesses. Accountants and bookkeepers managing several Xero organizations. Franchise and multi-location operators. Finance and operations managers.

Real-world use cases

  • Publish a master supplier list from the head office Xero organization to every subsidiary, so all entities pay vendors using the same up-to-date details.
  • Two-way sync shared customers between two related Xero organizations, such as a sales company and a service company that invoice the same clients.
  • Consolidate customers from several regional or franchise Xero organizations into one group organization for a central view of all clients.
  • Copy all contacts from an old Xero organization to a newly created one when restructuring a business or setting up a new legal entity.
  • Sync only contacts with a specific account number prefix from one Xero organization to another, keeping entity-specific contacts private.
  • Sync contacts across multiple Xero organizations and publish the combined list to the Microsoft 365 Global Address List so all staff can find them in Outlook.
  • Create new HubSpot contacts in your main Xero organization and share them automatically with a second Xero organization that also invoices those clients.
  • Keep contacts aligned between two Xero organizations and a QuickBooks company when part of the group runs on a different accounting system.
  • Merge suppliers from several Xero organizations into Google Contacts for the purchasing manager, so every vendor is reachable from one phone.

Key features

Multi-Entity Sync

Keep customers and suppliers consistent across any number of Xero organizations, one-way, two-way, one-to-many or many-to-one.

Selective Sharing

Use no-code filters to share only suppliers, only customers, or any group of contacts based on names, emails, account numbers and more.

Duplicate Prevention

Initial merge matches existing contacts in each organization, and smart naming resolves Xero's unique-name conflicts automatically.

Safe Archiving

Removed contacts are archived instead of permanently deleted, so the invoices and history in every organization stay intact.

Complete Contact Details

Sync names, emails, work, mobile and fax numbers, postal and street addresses, and account numbers between organizations.

Affordable & Scalable

With SyncPenguin you only pay for changes to your data, regardless of how many contacts you have now or will have in the future.

Things to note

  • Each Xero connection syncs one organization, so add a connection for every organization you want to include in the sync.
  • One email address is synced per contact (the primary email). Additional contact persons stored under a Xero contact are not synced.
  • Up to three phone numbers (work, mobile and fax) and two addresses (postal and street) are synced per contact.
  • Xero sets customer and supplier status automatically based on invoices and bills, so these statuses are used for filtering and are not copied between organizations.
  • The website field is read-only and cannot be written to the target Xero organization. Xero contacts do not offer custom fields, so these are not synced either.
  • Xero does not allow permanent deletion, so synced deletions archive the contact in the other organization, which keeps its history intact.
  • Changes are picked up during periodic sync runs, and very large initial syncs may take longer because SyncPenguin respects Xero's API rate limits.

How to configure the sync?


This guide explains in detail how to create, configure, and start the sync.

If you'd like to start syncing right away, feel free to create an account and set up the sync on your own. Come back to this guide if anything is unclear. You can also contact us with any questions, requests, or feedback.

Step 1. Create a SyncPenguin account

The first step is to create a SyncPenguin account. We offer a free 14-day trial (no credit card required), so you can make sure everything works well before you commit. Follow the link below to create an account.

14-day free trial • no credit card required • quick setup

Step 2. Create the sync

Next, create a sync in the Synchronizations section of the dashboard by clicking the + New sync button. You'll see a wizard page where you need to do the following:

  • Choose Xero Contacts for the first app.
  • Then choose Xero Contacts for the second app.
  • Then select the sync direction.
  • Then click the Create button.

Step 3. Provide access to Xero

Now that your sync is created, the next important step is to grant SyncPenguin access to your contact data. You'll see an Account section for each app involved in the sync. Below we explain how to connect and configure each account.

How to connect Xero?

This is a preview of the connection form in your SyncPenguin dashboard, shown for illustration only. Don’t enter any credentials here.
The Xero Contacts account connection section will look like this:

Account for Xero Contacts (Example)
Xero Contacts

Please make sure both apps are properly connected before starting the contact sync.

DATA SECURITY

If you're concerned about the security of your data, please check out our Security Practices page.

Step 4. Sync settings

In the Sync settings section, you can adjust some of the default settings of your sync:

  • The name of your sync.
  • Sync direction (two-way or one-way).
  • Sync interval (by default, the sync runs every 10 minutes).

Additionally, in Field mappings & rules you can customize how contact data is mapped between the apps, or add filters and custom rules to the sync. This is done using our simple no-code visual interface, which lets you make simple adjustments as well as implement complex custom scenarios.

Supported Xero fields: First name Last name Contact / company name Email address Phone numbers (work, mobile, fax) Addresses (postal, street) Website (read-only) Is customer Is supplier Account number

Virtually any syncing behavior based on supported fields is possible using the customizations interface.

Learn more about our customization interface.

Sync settings

Step 5. Start the sync

The last step is to start the sync. To do that, click the Start syncing button.

You'll then be offered the following options:

  1. Only sync new data, meaning anything added or updated from now on.
  2. Merge all historic data two-way: take all Xero Contacts and merge them together. Any data that already exists in both apps is merged instead of being duplicated.
  3. Merge Xero Contacts A into Xero Contacts B: take all Xero Contacts A and add/merge them into Xero Contacts B. Here A and B are used to distinguish the two data sources.
  4. Merge Xero Contacts B into Xero Contacts A: similar to the previous option but in the opposite direction.
Start sync
We'll be checking every 10 minutes for changes in your data.
What should we do initially with already existing contacts?

Once you've made your choice, click Start syncing. If you choose an initial merge, it'll be queued immediately. Once it's done, we'll check for contact changes at the sync interval you've set and sync them accordingly. Each sync run is shown in the Sync history at the bottom of the sync page.

Learn more

Frequently Asked Questions

Can I sync contacts between two different Xero organizations?

Can I share contacts with more than two Xero organizations?

Can I sync only suppliers or only customers between Xero organizations?

Will contacts that already exist in both organizations be duplicated?

What happens if a contact is deleted in one Xero organization?

Is this useful when migrating to a new Xero organization?