This is not a two-click integration, and we'd rather say so now
QuickBooks Desktop has no API in the cloud. There is nothing for us to sign into on your behalf, because your company file sits on a Windows computer in your office and never leaves it. So the connection runs the other way round: a small Intuit program called the QuickBooks Web Connector runs on that computer, and it calls us on a schedule.
That means part of this setup happens inside monday.com, and part of it happens at the Windows machine where QuickBooks lives. They are usually not the same computer. Nearly every setup that goes wrong goes wrong because somebody got to step three on a laptop in a different building.
Every message this app sends to QuickBooks is a query. There is no code in it capable of adding, changing or deleting anything in your books — that isn't a setting you could switch on by accident, the capability doesn't exist. Data moves one way: QuickBooks to monday.com.
Six things to check
Every item here has broken a real setup. Checking them now takes a minute. Diagnosing them later, from a Web Connector error code, takes considerably longer.
- QuickBooks Desktop for Windows: Enterprise, Premier or Pro 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. Enterprise is what this app is built and tested against; Premier and Pro use the identical connector and behave the same, with smaller list limits.
- 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 3 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 that machine isn't behind will fail the setup for reasons that have nothing to do with QuickBooks, and the error won't say so.
- You're an admin on the monday.com account Installing an app and granting it access to boards are both admin actions. If you open the app as a viewer or a guest, it will tell you so plainly rather than letting you get halfway and fail — but you'll still need an admin to finish.
The five steps
Open the app in monday.com
After installing from the monday.com marketplace, open the app from your account's app area. The first screen explains the three stages of setup before asking you for anything, and it names the one that surprises people: step two happens on the QuickBooks computer.
Give your company file a name if you like — Company name is optional and only exists so that a second company file, later, is distinguishable from the first.
Connect monday
Click Connect monday. A new tab opens with monday's own consent screen, listing what the app is asking for: read your account and the user connecting, list workspaces, read boards and their columns, and create and update items.
It opens in a new tab because monday refuses to render its own consent screen inside another app's frame. When you've approved it, come back to the first tab and click I have finished — refresh. There's no signal that tells the app you're done, so it asks rather than spinning forever.
Creating and updating board items is the product — that's the permission doing the work. It reads boards and columns so you can map QuickBooks fields onto columns that already exist, and so that an invoice that's already on a board gets updated instead of added a second time.
Get the setup file and password
Click Get the setup file and password. You'll see a generated user name and password, and a Download the setup file button that gives you a file named quickbooks-monday-….qwc — a small configuration file telling the Web Connector where to call and who you are.
The password is shown exactly once. Copy it somewhere before you close the panel. If you lose it, come back and generate a new one — that's normal and costs nothing except retyping it in the Web Connector.
The download link is valid for two minutes. If you're doing this on a different computer from the QuickBooks machine, get to that machine first, then click download.
Add it in QuickBooks
This is the step setups actually fail on, so take it slowly. Everything here happens on the Windows computer where the company file lives.
- 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…
- In the Web Connector, choose Add an Application and pick the .qwc file you downloaded.
- When prompted, enter the password from step 3.
QuickBooks will ask how this application may access the company file. Choose "Yes, always allow access even if QuickBooks is not running."
This is the single most important click in the whole setup. Any other answer works fine for as long as QuickBooks stays open, and then fails with QBWC1013 the moment somebody closes it at six o'clock. Your boards quietly stop updating overnight, and the numbers on screen still look like today's. Nothing warns you.
QuickBooks will also ask about access to personal data — customer names, addresses, invoice detail. Accept it, or customers and invoices arrive with the identifying fields empty.
The connector file declares itself as not read-only, because the Web Connector 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 does not widen what the software does. Every message this app sends is a query, and there is no code in it that writes to your books.
The first sync
In the Web Connector, tick the box beside QuickBooks Desktop for monday.com and click Update Selected.
The first run reads your history and is by far the heaviest one you'll do. On a large Enterprise file it can take a while, and the Web Connector's progress bar is the honest picture of where it is. Start it outside business hours if your file is big. After that it keeps everything current on its own.
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 boards quietly go stale.
Choosing your boards
Once QuickBooks has sent its first batch, the app's screen shows What goes onto your boards — a row for each kind of record: customers and jobs, invoices, estimates, sales orders and items.
For each one you can point it at a board you already have, or let the app build the board for you with columns that already match. Building it for you is the faster path and the one to take unless you have an existing board the rest of your team already works in.
Mappings are checked before they're saved. A column that doesn't exist, or one of the wrong type for the field you've pointed at it, is rejected then and there — rather than silently failing on every sync for the next three weeks.
You can pause a record type without losing which columns it fills. Useful if you want invoices flowing today and estimates later.
QuickBooks structures jobs underneath customers — Prentice, Adelaide:Guest Villa. That structure is carried onto the board, so you can see not just who owes you but which job the money is against. For construction and manufacturing teams this is usually the reason for installing it at all.
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 |
|---|---|---|
| QBWC1013 | "Could not start QuickBooks." Either the company file is closed and the application was never granted unattended access, or the file has moved, or the machine went to sleep. If this appears every evening and clears every morning, it is the authorisation answer from step 4. | Remove the application from the Web Connector, add the .qwc again, and this time choose "Yes, always allow access even if QuickBooks is not running." |
| 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 almost never is 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 address 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. |
| Auth failed | Wrong Web Connector password, or a password that was regenerated in monday after this application was added. | Generate a new password in the app and retype it in the Web Connector. The two only have to match each other. |
Nothing is arriving on a board
Work down this list, in order — it's roughly the order of how often each turns out to be the answer.
- Has QuickBooks run at all? On the QuickBooks computer, the Web Connector's last result should say the sync completed. If it doesn't, the problem is on that machine and the table above covers it.
- Is that record type pointed at a board? A row with no board has nowhere to put anything.
- Is it paused? The row says so.
- Is it included in your plan? The row says that too, with a link to change plan. Nothing is lost while a record type is outside your plan — it stays staged, and it goes out on the next sync after you upgrade.
- Try Sync now. It isn't rate-limited, so it's a safe thing to press when you're unsure.
If you run QuickBooks in a hosted environment
Hosted QuickBooks — Rightworks and similar — runs your company file on somebody else's Windows server that you reach over Remote Desktop. The Web Connector runs there too, which means it only runs while that Remote Desktop session is alive. Close the session and syncing stops until you sign back in.
It works, but it isn't unattended in the way a local install is. Tell us if this is your setup and we'll go through the options with you.
Multi-user mode
Add the application in single-user mode. Once it's registered, multi-user mode is fine for ordinary use — it's the first registration that QuickBooks refuses.
Pausing or removing the app
Three levels, and they do different things.
Pause a record type. In the app, on that row. Everything else carries on. Nothing is forgotten — the board and the column mapping are still there when you resume.
Stop reading from QuickBooks. In the Web Connector, untick Auto-Run or remove the application. Nothing further is read from your company file.
Uninstall the app from monday.com. This stops the sync completely and starts a deletion clock. If you don't reconnect, everything we hold for that connection — the staged QuickBooks records, your encrypted Web Connector credentials, your monday tokens, the board mappings and the sync history — is permanently erased within ten days.
Uninstalling and reinstalling is a normal way to try to fix something. If we erased everything the instant you uninstalled, that troubleshooting step would destroy your entire setup, with no way back. So the clock starts, and reconnecting stops it.
Items already created on your boards stay exactly where they are. That data lives in your monday account and it's yours — deleting it, if you want it gone, is done from the boards themselves.
Stuck on a step, or seeing something this page doesn't cover? Email karim@agoracrew.com and tell us which step and what the Web Connector said. The Web Connector keeps its own log, and its location is shown in the Web Connector window — sending us the last few lines of it usually answers the question in one reply rather than four.