How to connect HubSpot to QuickBooks and confirm the sync is working

To connect HubSpot to QuickBooks, install the QuickBooks app from HubSpot’s app marketplace, sign in to the QuickBooks company you want linked, approve the access request, and then set up what should sync. Before you turn it on, check that you have the right HubSpot and QuickBooks accounts, the right permissions, and the right plan or version for the integration you want. The part that usually causes trouble is not the install itself, but choosing the wrong company or skipping the field-mapping check.

What you need before connecting HubSpot and QuickBooks

Before you start, have these ready:

• A HubSpot account with permission to install apps or manage integrations.
• The QuickBooks account you want connected, with permission to authorize third-party access.
• Access to the exact HubSpot portal and QuickBooks company you want to use, if your business has more than one.
• A clear decision about what should sync: contacts, customers, invoices, payments, or a mix of those.
• A check on whether your HubSpot and QuickBooks versions or plans support the integration you want. Some integrations only work with specific QuickBooks products or HubSpot subscription levels, so confirm that before you start.

If you do not have admin access in one system, stop there and get the right person to sign in. Trying to work around permissions usually leaves you with a half-finished connection that is harder to sort out later.

How to connect the two accounts step by step

1. Open HubSpot and go to the app marketplace or integrations area. Find the QuickBooks app in the list of available apps. If your HubSpot account has more than one portal, make sure you are in the right one before you install anything.

2. Select the QuickBooks integration and start the connection. Choose the button to connect, install, or authorize. The exact label can vary, but the next screen should take you to a QuickBooks sign-in or permission prompt.

3. Sign in to the QuickBooks account you want linked. Use the same QuickBooks company that stores the billing data you expect HubSpot to work with. If you manage multiple companies, this is the point where it is easy to connect the wrong one.

4. Approve the access request. QuickBooks will ask you to allow HubSpot to read or write certain data. Review the permissions on that screen, then approve them so the app can finish connecting.

5. Return to HubSpot and finish the setup flow. After QuickBooks approves the connection, HubSpot usually sends you back to a setup screen where you confirm the integration is active. If the app asks you to choose an account or company again, re-check that it matches the one you intended to use.

6. Open the sync settings and choose what should move between the two systems. This is where you decide whether contacts, customers, invoices, payments, or other records should sync, and whether the sync is one-way or two-way.

What to check before you turn the sync on

Before you switch the sync on, confirm the mapping and sync direction. This is the part that keeps customer and billing records from landing in the wrong place.

Check these settings carefully:

• Which objects sync: contacts, companies, invoices, payments, or other records the app offers.
• Whether the sync is one-way or two-way.
• Which system creates new records first.
• Which fields map together, such as name, email, company, invoice number, amount, payment status, or customer ID.
• What happens when a matching record already exists in both systems.
• Whether the integration updates existing records or only creates new ones.

If you use HubSpot contacts as the starting point for sales and QuickBooks as the system of record for billing, make sure the field mapping reflects that. For example, you may want a HubSpot contact to create or update a QuickBooks customer, while invoice and payment details flow back into HubSpot for visibility.

If the app offers filters, use them. A filter can limit the sync to specific pipelines, record types, or tagged customers, which is safer than syncing everything at once. If you are unsure about a setting and there is no obvious preview, stop and verify it in the app’s setup screens before enabling the sync.

How to confirm it worked

The simplest check is to create one test record and watch where it appears.

1. Create or choose one test contact in HubSpot. Use a clearly labeled test record so you can spot it later. If the integration supports it, include the fields you expect to sync, such as email and company name.

2. Save the record and wait for the sync to run. Some integrations update right away, while others take a little time. Don’t make changes to multiple records at once until you know the first one has moved correctly.

3. Check QuickBooks for the matching customer or billing record. You should see the new customer, or the existing customer should update with the mapped information you expected. If you are testing invoice sync, create a simple test invoice and confirm it appears in the other system with the right customer attached.

4. Make one change in the system you expect to be the source of truth. For example, update the test contact’s email or add a note to the invoice, then confirm the same change shows up where the sync settings say it should.

If the test record shows up in the right place with the expected fields, the connection worked and you can start using it for real records.

If the connection fails or looks incomplete

If something goes wrong, check the most likely causes in this order.

• Permission problem: the person connecting the app may not have admin access in HubSpot or the right QuickBooks authorization role. Reconnect using an account with the needed permissions.
• Wrong account or company: the integration may be linked to a different HubSpot portal or a different QuickBooks company. Disconnect only after you confirm which account was used.
• Version or plan mismatch: the app may require a specific QuickBooks product or HubSpot plan. If the setup screen mentions a version or subscription level you do not have, check the integration’s current requirements in the product docs or app listing before you continue.
• Missing field mapping: the sync may be live, but the record fields you care about are not mapped. Go back to the mapping screen and confirm the customer name, email, invoice number, and payment-related fields.
• Duplicate record rules: an existing contact or customer may be preventing a clean match. Check how the app identifies duplicates, usually by email, customer name, or a custom ID.
• Partial sync settings: the integration may be configured to sync only certain record types. Make sure contacts, invoices, and payments are actually turned on where you expect them.

If the app reports an unsupported version or permission you can’t grant, stop there rather than forcing a workaround. The next step is to confirm the exact product version, plan, or admin role required, then reconnect with the correct account or settings.