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.
- Install the QuickBooks Online app from the HubSpot Marketplace and sign in to QuickBooks.
- In HubSpot, go to Settings, Integrations, Connected apps, QuickBooks Online, then the CRM syncs tab, and choose “Set up your sync”.
- For each record type, pick a direction and which system wins a conflict.
- Review the field mappings and turn off any field you do not want moved.
- 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.