Integration guides

How do I integrate HubSpot with Xero?

Nicolas Blassel, Co-founder

A new client signs, and someone in your team types the same name and billing email into the accounts, then again somewhere else. It happens in most firms, whatever they use for clients and whatever they use for accounts.

I will take HubSpot and Xero as the example, because the two already connect. HubSpot's own HubSpot Xero integration, called Data Sync, moves contacts, products, invoices and payments between them. Firms get stuck when nobody switched it on, or when they did and hit what it does not do, usually raising an invoice the moment a deal is won. Here is what it covers, what I would decide before connecting it, and where I would stop relying on it.

What does a half-connected HubSpot Xero integration cost a firm?

In most firms I see with 10 to 50 people, the cost is not one big failure. It is a string of small ones.

  • Finance asks sales for a new client's billing details, then types them in.
  • A partner chats to a client about an overdue invoice without knowing the payment landed on Tuesday.
  • A client is "Smith & Co" in Xero and "Smith and Company" in HubSpot, and nobody can say which is right.
  • An invoice goes out late because the won deal never reached the person who raises it.

The last one is its own problem, which I cover in creating a Xero invoice when a HubSpot deal is won.

Does HubSpot integrate with Xero?

Yes. HubSpot lists it in its Marketplace as "Xero by HubSpot (Data Sync)". Xero's App Store lists the same app, Data sync by HubSpot, for the United Kingdom, the United States, Australia, Singapore and several other countries.

What does the HubSpot Xero integration sync, and in which direction?

According to HubSpot's knowledge base (last updated 29 October 2026), you choose the direction per record type.

RecordXero sideHubSpot sideDirection options
ContactsContactsContactsOne way either way, or both ways
ProductsItemsProductsOne way either way, or both ways
InvoicesInvoicesInvoicesXero to HubSpot, HubSpot to Xero, or both ways
PaymentsPayments applied to invoicesPaymentsXero to HubSpot, or both ways

Three more things from the same page and the Xero listing:

  • Tax rates are imported from Xero into HubSpot. Rates created in HubSpot do not go the other way.
  • Quotes, deals and projects are not synced objects. A deal can become an invoice inside HubSpot and that invoice can sync, but the sync does not watch deal stages. Loco Digital's comparison makes the same point about quotes.
  • Switching on invoice sync switches on payment sync, according to the Xero App Store listing.

Which HubSpot and Xero plans does it need?

Fewer than most people expect. HubSpot's page lists the integration as available on all products and plans, with extra subscriptions only for certain features. Two requirements matter:

  • Permissions. You must be a Super Admin, or have App Marketplace permissions, in HubSpot.
  • Custom field mappings. You need at least Data Hub Starter. The default mappings come with the app.

Plans and permissions change, so I check that page again on the day we connect anything.

What does a proper HubSpot Xero setup involve?

The app installs in minutes. The work is in the stages around it. I follow HubSpot's own order, because the contact and products on an invoice must exist in Xero before the invoice can sync.

  1. Decide who owns what. I usually keep client details and the relationship in HubSpot, and invoices, balances and payments in Xero. Firms that skip this end up arguing later about which record is right.
  2. Clean the data on both sides. A client spelled two ways becomes two clients, and the sync will faithfully copy the mess. Someone has to decide which version survives.
  3. Map what travels and in which direction. Contacts first, then products, then invoices last. Each choice affects what can overwrite what.
  4. Test on a few real records before anything else moves. Clean sample data tells you very little.
  5. Switch over, then watch the failures for the first weeks. Errors nobody sees become a month of unsent invoices.

How do I avoid duplicate contacts in the HubSpot Xero sync?

Duplicates almost always come from decisions made before the sync starts, not from the app.

  • Direction. Two-way sync means an edit in either system can overwrite the other. HubSpot lets you choose which app wins a conflict, so choose on purpose.
  • Email. HubSpot says an invoice sync error often happens because the invoice contact does not share the Xero customer's email address.
  • Names. Xero requires unique contact names, so a HubSpot contact with the same name as a Xero one fails.
  • Volume. HubSpot recommends sending only contacts with at least one non-draft invoice. I agree: otherwise every lead can end up in your ledger.
  • Awkward fields. Xero contacts are often companies and HubSpot contacts are people, so decide where company name, billing email and tax number belong. A field such as PO number needs a custom mapping, which needs Data Hub Starter or higher.

How fast does the HubSpot Xero sync run?

HubSpot says changes made in HubSpot are detected within a few minutes, and changes made in Xero every 30 minutes. That is fine for most firms. If a step depends on the answer, such as checking a deposit before a kickoff, I would build around the gap.

What are the limits of the native sync?

These come from the HubSpot page above, and they are the ones that catch firms out.

  • Draft invoices do not sync to Xero. An invoice raised in HubSpot must be open first.
  • Invoices created in HubSpot must be edited in HubSpot. Change a line item or remove a payment in Xero and the sync fails.
  • Invoices that use HubSpot's automated sales tax do not sync, and neither do credit card fees turned on in HubSpot's payment settings.
  • Six currencies are supported: USD, CAD, EUR, GBP, AUD and NZD. A firm billing in CHF or SGD needs another route.
  • Only payments created after you connect will sync, and you cannot view or edit the payment sync settings.

None of these is a reason to avoid the sync. I read them as a reason to decide where invoices are raised, and to stick to it. If your invoicing runs into several of them, tell us how your firm bills and I will tell you honestly whether the native sync is enough.

Why does the HubSpot Xero sync fail, and what do the errors mean?

HubSpot lists the usual errors in the same article. In my experience each one points to a data problem, not a broken app. Here is how they tend to show up in a firm's week.

  • A client asks for invoices to go to a new billing address. Someone updates it in HubSpot but not in Xero, and the invoice fails with "An invoice should have an associated customer". Xero cannot match the contact because the email differs.
  • A bookkeeper spots a wrong line on an invoice raised in HubSpot and corrects it in Xero. The sync stops, because HubSpot says native invoice amounts "cannot be made through external applications".
  • Two clients both have a contact called Anna Müller, at different companies. The second one fails with "The contact name is already assigned to another contact".
  • Someone adds a new tax rate in Xero and it does not appear in HubSpot when the invoice is raised. Usually the import needs triggering again.

Fixing the message is easy. Fixing the habit that caused it is the real job.

Native sync, a marketplace app, Make or a custom build?

There are three routes, and most firms need the first plus, at most, one small addition.

RouteWhat it isGood for
HubSpot's Data SyncThe native appOne Xero organisation, standard fields, invoices raised in HubSpot
A marketplace app or workflow toolAnother publisher's app, or Zapier or MakeOne missing step, such as creating the Xero invoice from a deal stage
A custom buildCode against both APIsSeveral systems, several billing companies, or rules of your own

Marketplace apps exist for the deal to invoice step. HubSpot's Marketplace lists Xero Integration by Cloudify, which says it converts deals into Xero invoices, with its own subscription. I have not tested it, so read each listing for your plan. Zapier and Make also have HubSpot and Xero connectors, and according to Loco's comparison both can turn a changed deal stage into a Xero invoice without code.

I keep two rules for any mixed setup. Never let two tools write the same record, or the same client gets added twice. And use a connection owned by the firm, not one person's login.

When is a custom build worth it?

Mostly it is not. For a firm of 10 to 50 people, I would take native sync plus one or two focused automations every time. I would start talking about a custom build when:

  1. A third system must receive the same client record, such as a practice management, document or payment tool.
  2. More than one company bills from one HubSpot, and each deal must pick the right Xero organisation, tax treatment and currency.
  3. Your invoicing has rules the app cannot express, such as approval before an invoice is raised or part payments.

If you go that way, read what the Xero API pricing changes mean for custom integrations first, because Xero's API access terms changed in 2026.

Do it yourselves or have it done?

If you bill from one Xero organisation, in one of the six currencies, and invoices are raised in HubSpot, you can probably do this yourselves. Take your time over the cleaning and the decision about who owns what.

I would get help when:

  • Your client list is already full of near duplicates and nobody knows which record is right.
  • A won deal should raise an invoice and today someone does it by hand.
  • You bill in CHF, SGD or another currency outside the six, or from more than one company.
  • The person who set up the sync has left, and nobody knows what it is doing.

In those cases the risk is a sync that writes the wrong thing into your ledger and is noticed a month later. Either way, the next question is which route fits your firm.

Questions people ask

Is the HubSpot Xero integration free?

HubSpot lists it as available on all plans, and Loco's comparison says the app carried no separate charge as of September 2026. You still pay for HubSpot, Xero and, for custom mappings, Data Hub Starter. Marketplace apps and workflow tools charge their own subscriptions.

How Flow Mesh helps

If you want a second pair of eyes before you connect anything, we start with a stack audit. It writes down which records should flow where and which system owns each. If you then want us to build the connection, we scope it in writing and work inside your own accounts. If invoices and client details are still being retyped between the two, contact us and tell me how your firm bills today.

Nicolas Blassel

About the author

Nicolas Blassel, Co-founder

Nicolas Blassel has worked on software and data systems since 2007, including defence, aerospace and Paris 2024. He runs Flow Mesh's French missions himself, from the first call to go-live, connecting the software firms already use and working inside their own accounts after an NDA.

CHECKLIST

The SaaS stack self-audit: 12 checks

The same questions our paid audit starts with. Work through them in an hour and see whether your stack is costing more than the subscriptions. We'll email you the checklist.

More articles

See all articles →