Five things to check
Every item here has broken a real installation. Checking them now takes a minute. Diagnosing them later, from a Web Connector error code, takes considerably longer.
- QuickBooks Desktop for Windows: Pro, Premier or Enterprise QuickBooks Online and QuickBooks for Mac can't connect this way. The Web Connector doesn't exist for them, so there's no version of this that works.
- QuickBooks Web Connector installed on that same computer It ships with most QuickBooks Desktop installations. Look in the Windows Start menu for "QuickBooks Web Connector". If it isn't there, install it from Intuit first; otherwise the file you download in step 5 has nothing to open it with.
- You're at the computer where QuickBooks itself runs The Web Connector needs direct access to the company file. If your file lives on an office server that staff reach over Remote Desktop, do this inside that Remote Desktop session. Being able to open the file from your own desk in multi-user mode isn't the same thing, and this catches people out regularly.
- You can open the company file as the QuickBooks Admin user Only Admin can approve a new connected application. Sign in with a limited-access login and QuickBooks rejects the whole registration, not just the first sync.
- That computer can reach the internet through whatever firewall it sits behind Before it will add an application, the Web Connector quietly loads our address itself to check it's reachable, then reports anything it can't load as a certificate problem. So a corporate proxy your laptop isn't behind will fail the install for reasons that have nothing to do with QuickBooks, and the error won't say so.
You'll also need a HubSpot account you can approve app installations in, and ten uninterrupted minutes.
Setting it up
Your details
Open your setup link and fill in your business name and email. Two other fields matter more than they look:
The currency your HubSpot account uses. This defaults to USD. Change it only if you know your HubSpot portal is set to something else. Get it wrong and invoices will fail to sync until it's corrected.
The terms checkbox. The form won't submit without it.
The URL contains a long unique ID, and that ID is the only thing protecting the flow. Anyone holding the link can reach your download page and your Web Connector password. Don't paste it into a shared Slack channel or a support ticket. If you lose it, "Already started? Get your link" at the bottom of the setup page will email it back to you.
Connect HubSpot
Click Connect HubSpot. HubSpot takes over from there: you sign in, choose which account to install into, and review the permissions. When you land back on the wizard it will say Connected.
HubSpot shows ARBridge as an unverified app and asks you to accept the risk before continuing. There's currently no way around this. HubSpot only awards the verified badge to apps that have been listed on their Marketplace for six months with 60+ installs, so it's a statement about how long the app has been on their marketplace, not about its security.
Three quick questions
You'll be asked whether you use class or location tracking, whether you bill retainage, and whether you use progress invoicing. Answer honestly. None of the three changes what syncs today; they tell us what to build next, and the page says as much.
The pre-flight checklist
The same five items from the top of this page, as tick boxes you can't skip. We can't inspect your computer from our side, so we ask instead.
Please don't tick them out of habit. If items 3 or 4 aren't actually true, stop and sort that out first. It's the difference between a ten-minute install and an afternoon.
Connect QuickBooks
This is the step installations actually fail on, so take it slowly.
Download your connector file. The button gives you middleman.qwc, a small configuration file telling the Web Connector where to call and who you are.
Note your Web Connector password. The page shows a generated username and password, hidden behind a "Show password" toggle. QuickBooks asks for the password the first time you add the file. Write it down, though you can always come back to this page for it.
Add the file in QuickBooks:
- Open QuickBooks Desktop and the company file you want to sync, signed in as Admin.
- Go to File → App Management → Update Web Services. On older versions this lives at File → Utilities → Add/Remove…
- Select the middleman.qwc file you downloaded.
- When prompted, enter the password from the download page.
"Allow access even when QuickBooks is not running?" Say yes if you want the sync to run unattended. This is the option you want.
"This application requests read and write access." Here's the honest explanation. The connector file declares itself as not read-only because the Web Connector itself writes a small tracking marker into your company file whenever any application registers. That write is Intuit's, not ours, and it happens for every integration. We tried declaring strictly read-only; QuickBooks rejected the registration outright with error QBWC1080. So the declaration widens what QuickBooks would permit. It doesn't widen what the software does. Every message ARBridge sends is a query, and there's no code in it that writes to your books.
Starting the sync
In the Web Connector, tick the box next to ARBridge and click Update Selected.
The confirmation page refreshes itself every 15 seconds, so leave it open on a second screen. It changes from "Almost there" to "You're all set" with real counts, something like 147 customers and 892 invoices synced.
That first run reads your history and is the heaviest one you'll do. On a large company file, start it outside business hours. After that the Web Connector keeps everything current on its own every 15 minutes.
Set Auto-Run in the Web Connector with an interval of 15 minutes. Without it the sync runs only when somebody clicks Update Selected, which means it stops silently the moment that window closes and your HubSpot data quietly goes stale.
Switching the data on in HubSpot
HubSpot never puts an app's card or properties onto a record page by itself. That's true of every marketplace app. Until a Super Admin switches them on, once, your records look precisely as they did before you installed anything, and a working sync is indistinguishable from a broken one. More installs get reported as failures for this reason than for every genuine fault combined.
Switch on the AR card
In HubSpot, go to Settings → Integrations → Connected apps → ARBridge for QuickBooks → App cards → QuickBooks AR Summary → Manage locations, tick the company views, and save.
Every synced company now carries a QuickBooks AR panel on its record: total outstanding, the ageing breakdown, credit status, last payment, and the two revenue figures. This is the step that makes the product visibly exist.
Add the AR fields to the record view
Open any company record, choose Customise the middle column, and add the fields your team needs (ar_total, ar_current, the ageing buckets, credit_status).
Worth doing both. The card shows everything at a glance, but only the properties can be filtered, sorted, and built into lists and workflows.
If you already had companies in HubSpot
Some QuickBooks customers may be held for a matching decision rather than guessed at, and they'll appear on your status page with a link to a review screen. Where there's one obvious candidate, a single "Link all" button handles them together.
Ignoring it is safe. After seven days those customers are added as new records and the sync carries on regardless.
What the error codes actually mean
The Web Connector's codes aren't self-explanatory, and two of them are actively misleading. Here's what each one usually is in practice.
| Code | What it usually means | What to do |
|---|---|---|
| QBWC1080 QBWC1039 |
QuickBooks refused the registration. Nearly always because the company file wasn't open as Admin, or it was in multi-user mode when the application was first added. | Close the file, reopen it in single-user mode signed in as Admin, and add the .qwc again. |
| QBWC1048 QBWC1051 |
Reported as a certificate error, though it usually isn't one. Before registering, the Web Connector runs a plain reachability check against our address and reports anything it can't load this way. | Check that that computer can open our site in a browser. A corporate firewall or proxy is the usual culprit. |
| QBWC1073 | "The host names for the service and support URLs do not match." A configuration problem on our side, not yours. | Send us the error. Please don't edit the .qwc file by hand. |
| QBWC1013 | "Could not start QuickBooks." The Web Connector can't reach the company file, usually because it's closed, has moved, or the machine went to sleep. | Open QuickBooks with the right company file and run Update Selected again. |
| Auth failed | Wrong Web Connector password. | Go back to your download page, which always shows the current password, and re-enter it. |
If it stops working later
Check your status page first. It shows the last successful sync and anything currently failing, which answers most questions on its own. Then check the Web Connector on the QuickBooks machine: if its last result isn't "Sync complete", the problem is on that computer, and it's usually a sleeping machine or a company file that moved.
We'll also email you if a connection goes 72 hours without a successful sync. One email per episode, not one an hour, and it clears itself once syncing resumes.
Pausing or removing ARBridge
Two levels, and they do different things.
Pause the sync. In the Web Connector, untick Auto-Run or remove the application. Nothing further is read from QuickBooks.
Disconnect properly. From your status page. This stops the sync and purges the stored QuickBooks password and HubSpot token. Records already written to HubSpot stay exactly where they are, because that data is yours.
To clear those records too: every company ARBridge created carries a property called qb_customer_id_v2. Filter your Companies list on "qb_customer_id_v2 is known", select all, delete. Disconnect first, or the next sync will simply put them back.
Nothing you or your team does in HubSpot is ever written back to QuickBooks. Your books can't be altered by this integration, and that's a deliberate limit rather than a feature waiting to be added.