Skip to content
CentriWeb
Not sure where to start?

Tell us how the business runs. We'll tell you what we'd build first.

Book a call
For builders and tradesPreBuildMore homeowner enquiries, more trust, more jobs won. For sole tradersOwner CFOA financial operating system for owners who do the books.
Need something of your own?

We build custom software too.

Talk to us

HubSpot QuickBooks integration: set-up and what it syncs

What HubSpot's QuickBooks Online app syncs each way, how to set it up, where it stops and what to ask your bookkeeper.

The HubSpot QuickBooks integration is an app from the HubSpot Marketplace that syncs customers, products, invoices and credit memos between HubSpot and QuickBooks Online, in the direction you choose for each. It works well for keeping billing details matched, and it has clear gaps around tax, refunds, card fees and payments that cover more than one invoice.

This article follows HubSpot’s own help pages, read in November 2026. It covers what moves, how to set it up, where it stops and what to ask your bookkeeper before you switch it on.

What the HubSpot QuickBooks integration syncs

HubSpot’s help page lists four pairs of records. Each pair can sync one way or both ways, and you pick the direction during set-up.

HubSpot record QuickBooks Online record
Contact Customer
Product Products and Services
Invoice Invoice
Credit memo Credit memo

Payments are not a separate record in that list. They travel with invoices and credit memos, and HubSpot says payment details also show on the related deal. The app is available on all HubSpot plans, though some features need extra subscriptions. You need to be a Super Admin or have App Marketplace permissions to install it (HubSpot: connect HubSpot and QuickBooks Online).

How the sync runs and how fast

After set-up, HubSpot says changes made in HubSpot reach QuickBooks within a few minutes, and changes made in QuickBooks reach HubSpot every 30 minutes. There is also a “Sync now” option for when you cannot wait. You decide which side wins when the same field differs: HubSpot’s data or QuickBooks’ data.

Invoices created in HubSpot are checked against the filters you set, and only the ones that pass go across. HubSpot applies recommended filters by default so you do not push every record in the account. If an invoice fails, a banner on the invoices page links to the failure details (HubSpot: using the QuickBooks sync for invoices).

How to set up the HubSpot QuickBooks integration

HubSpot suggests talking to your accounting team before you connect, and that advice is worth following. The steps are short, but the choices you make in them decide which system owns your customer and invoice data.

  1. Install the QuickBooks Online app from the HubSpot Marketplace and sign in to QuickBooks.
  2. In HubSpot, go to Settings, Integrations, Connected apps, QuickBooks Online, then the CRM syncs tab, and choose “Set up your sync”.
  3. For each record type, pick a direction and which system wins a conflict.
  4. Review the field mappings and turn off any field you do not want moved.
  5. Set the sync filters, for example only contacts that have an invoice.

A QuickBooks sandbox account cannot be connected, so you cannot rehearse on a test company. The safer approach is to start with one object, such as products, check the result with your bookkeeper, then add invoices.

What the HubSpot QuickBooks integration does not do

Most complaints come from a handful of limits that HubSpot states on its own pages. Know them before you rely on the sync.

  • Tax. HubSpot says invoices cannot be created with tax, and invoice-level taxes and fees are not supported. Its advice is to add tax and fees as line items, ideally using products synced from QuickBooks. HubSpot also says non-US QuickBooks accounts that need tax on invoices cannot use the invoice feature.
  • Edits in QuickBooks. Some edits to invoices created in HubSpot cannot be made in QuickBooks, such as adding or removing line items or changing prices.
  • Payments. Payments that cover several invoices do not sync to HubSpot, and only payments made after you connect the app sync. HubSpot also says not to edit QuickBooks payment records that began in HubSpot.
  • Card fees. Processing fees do not create an expense in QuickBooks. HubSpot suggests totalling the fee properties in a report and entering the amount in QuickBooks yourself.
  • Refunds. Refunds do not sync automatically. For Stripe or HubSpot Payments, HubSpot says to record a credit memo or refund receipt in QuickBooks.
  • Credit memos. The integration supports applying a credit memo to one invoice per payment.
  • Custom fields. Something like a purchase order number has no default mapping. Custom field mappings are available with Data Hub Starter, Professional or Enterprise.

Sources: connect page and invoice page.

Common failures and how HubSpot says to fix them

HubSpot’s troubleshooting page lists the causes that come up most. These are worth printing for whoever looks after the books.

Problem Cause Fix
Customer not found The invoice contact’s email does not match the QuickBooks customer’s email Switch the invoice to the contact whose email matches
Duplicate display name QuickBooks needs unique display names, and later contacts from one company reuse the first name Give each customer a unique display name
Invoice changed in QuickBooks Line items, amounts or tax edited on a HubSpot invoice Revert in QuickBooks and edit in HubSpot
Duplicate document number Number already used, often with Custom Transaction Numbers on Fix the numbers, then turn that setting off
Revenue recognition QuickBooks wants a service date on each line and HubSpot lines cannot have one Turn off revenue recognition in QuickBooks

Two more points from HubSpot’s pages are easy to miss. Only the first three custom invoice fields created in QuickBooks show in HubSpot. And with two-way invoice sync, payments that came from invoices should be excluded from the “Create paid invoice” workflow action, otherwise you can create duplicates (HubSpot: troubleshoot the QuickBooks sync).

What to agree with your bookkeeper first

The sync moves records, but it does not decide how your business works. Settle these points before you connect, and write them down so the next person who touches the file knows the rules.

  • Which system owns customers. If QuickBooks is the master list, sync customers into HubSpot and set QuickBooks to win a conflict. If sales teams create contacts first, go the other way.
  • Where invoices are created. HubSpot says some edits cannot be made in QuickBooks to an invoice that began in HubSpot, so pick one place to create and one place to change.
  • How tax and fees are shown. Because invoice-level tax is not supported, decide which product lines carry tax and which QuickBooks products they match.
  • Who books card fees and refunds. These are manual in the built-in app, so name the person and the day of the month.

Here is a worked example with made-up numbers. A service business sends 40 invoices a month and 6 of them are paid by one cheque covering several jobs. Those 6 payments will not sync to HubSpot, so someone has to mark the HubSpot side by hand. That is about six small tasks a month, which is easy to live with. If it were 60 a month, the same gap would justify looking at a custom connection.

Where a custom connection fits better

The built-in app is the right starting point for a business that creates a modest number of invoices, bills in one currency and tax setup the app supports, and has a bookkeeper happy to handle fees and refunds by hand. Try it first.

A custom connection is worth considering when the gaps above cost real hours: invoices that need tax handled a specific way, payments that cover several invoices, fees that must be booked automatically, or a rule such as “create the QuickBooks invoice only when the deal is won and the deposit has cleared”. CentriWeb builds most client automations in n8n and looks after them afterwards, as part of its run with less admin service. Our view favours custom work, so weigh it with that in mind.

It does not suit a very small team with a handful of invoices a month, or an owner who is happy to fix a mismatch once a week. For a wider look at CRM and accounting pairings, see our guide to CRM for QuickBooks, and for card payments see Stripe and QuickBooks. If you are also building follow-ups inside HubSpot, HubSpot workflows covers what a service business should set up.

Common questions.

How often does the HubSpot QuickBooks integration sync?

HubSpot says changes made in HubSpot reach QuickBooks Online within a few minutes, and changes made in QuickBooks reach HubSpot every 30 minutes. You can also use Sync now to run it on demand.

Can I connect a QuickBooks sandbox company to test it?

No. HubSpot states that a QuickBooks sandbox account cannot be connected. Start with one record type on your real company file and have your bookkeeper check the result.

Why is my HubSpot invoice not appearing in QuickBooks?

HubSpot lists the usual causes: the invoice contact's email does not match a QuickBooks customer, the invoice does not pass your sync filters, or a document number or display name is already in use. The failure banner on the invoices page links to the detail.

Should I edit a synced invoice in QuickBooks?

Not if it began in HubSpot. HubSpot says edits to line items, prices or tax in QuickBooks cannot sync back, so make those changes in HubSpot.

Related guides.

Automation · 5 min read

What is n8n, and what can a small business use it for

Automation · 5 min read

n8n templates: which ones a small business can use

Automation · 6 min read

Hiring an n8n automation agency or expert: what to ask first

Talk to CentriWeb about this

CentriWeb sets up follow-ups, reminders and admin that run on their own, connected to the tools a business already uses. The first call takes 30 minutes and is free.

Or call +61 483 957 775 or email info@centriweb.com. CentriWeb is based in New Zealand and works online with businesses worldwide.

Ask a questionBook a call