# QuickBooks Desktop — Accounting API: connection

> Canonical URL: https://developers.apideck.com/apis/accounting/quickbooks-desktop/connection

# Connecting QuickBooks Desktop to Apideck

This guide walks you through connecting your QuickBooks Desktop company file to Apideck so your data can sync through Unify. The connection runs through the **QuickBooks Web Connector**, a small app from Intuit that lives on the same Windows machine as QuickBooks Desktop.

> 🎬 **Prefer video?** The whole setup is also covered in a two-part walkthrough (7½ minutes total): [Connect QuickBooks Desktop to Apideck: Part 1](https://www.loom.com/share/16ab38dc1e964b0eb1fe87c8a18322e1) and [Part 2](https://www.loom.com/share/c4d01e14a3314d70980300ca91d9bccf).

---

## Prerequisites

- **QuickBooks Desktop is installed and open**, with the company file you want to connect.
- **The QuickBooks Web Connector is installed** on the same Windows machine as QuickBooks Desktop (it ships with QuickBooks Desktop; look for it in your Start menu or QuickBooks program folder).
- **You're signed in as a QuickBooks Admin**: authorizing a new application in the Web Connector requires QuickBooks Administrator rights.
- **You have access to the connection in Apideck** (Unify → QuickBooks Desktop): that's where you'll get the Web Connector password and setup file in Step 3.

---

## Step 1: Open QuickBooks Desktop

1. Launch QuickBooks Desktop.
2. Open the company file you want to connect.

   ![Open the company file you want to connect in QuickBooks Desktop](https://res.cloudinary.com/apideck/image/upload/v1782377349/docs/connectors/quickbooks-desktop/quickbooks-desktop-open-company.png)

3. Leave QuickBooks running: it must stay open during setup and while syncing.

> ⚠️ **Only one company file at a time.** Make sure you don't have a second QuickBooks window or a second company file open. The Web Connector refuses to connect if it sees more than one running instance of QuickBooks (see Troubleshooting).

## Step 2: Open the QuickBooks Web Connector

Find it in your Windows **Start menu** or your QuickBooks program folder, and open it. This is the window that manages the connection and runs the syncs.

![Open the QuickBooks Web Connector](https://res.cloudinary.com/apideck/image/upload/v1782377349/docs/connectors/quickbooks-desktop/open-web-connector.png)

## Step 3: Get your connection file from Apideck

1. Open the connection in Apideck (Unify → **QuickBooks Desktop**). You'll land on a page showing a **Web Connector Password** and a **Web Connector Setup File** download.
2. Copy the **Web Connector Password** shown: you'll need it in a moment.
3. Click **Download apideck.qwc** to save the setup file.

   ![Apideck Vault: copy the Web Connector Password and download apideck.qwc](https://res.cloudinary.com/apideck/image/upload/v1782298582/docs/connectors/quickbooks-desktop/vault-unauthorized.png)

> 🔑 **Keep the password and the `.qwc` together.** Each time you download a new `.qwc`, Apideck generates a **new** matching password. Always use the password and the file from the *same* download: mixing an old password with a new file (or vice versa) will fail to authorize.

## Step 4: Add the connection in the Web Connector

1. In the Web Connector, click **Add an Application**.
2. Select the `.qwc` file you just downloaded.
3. When QuickBooks asks whether to allow access, choose **Yes** to authorize it.

   ![QuickBooks authorization prompt](https://res.cloudinary.com/apideck/image/upload/v1782297693/docs/connectors/quickbooks-desktop/quickbooks-desktop-auth-prompt.png)

4. Paste the password from Step 3 into the **Password** field for the new row.
5. Tick the **checkbox** next to the Apideck application, then click **Update Selected** to start the first sync.

   ![Apideck application added in the Web Connector](https://res.cloudinary.com/apideck/image/upload/v1782297693/docs/connectors/quickbooks-desktop/quickbooks-desktop-app-installed.png)

## Step 5: Confirm the sync and save in Apideck

1. In the Web Connector, watch the progress bars reach **100%** and the Status column show **Last result: Complete**.
2. Go back to Apideck Vault and click **Save** to verify the connection.

   ![Click Save in Apideck Vault](https://res.cloudinary.com/apideck/image/upload/v1782298468/docs/connectors/quickbooks-desktop/vault-save-changes.png)

3. The connection now shows **Connected**.

   ![Connection shows Connected in Apideck Vault](https://res.cloudinary.com/apideck/image/upload/v1782297693/docs/connectors/quickbooks-desktop/vault-authorized.png)

Data now flows between QuickBooks Desktop and Apideck.

---

## Troubleshooting

QuickBooks Desktop error messages are often cryptic and don't say what they actually mean. Here are the ones you're most likely to hit.

![QuickBooks Desktop error example](https://res.cloudinary.com/apideck/image/upload/v1782297693/docs/connectors/quickbooks-desktop/quickbooks-desktop-error.png)

| What you see | What it actually means | How to fix it |
|---|---|---|
| **QBWC1039: "not supported while multiple instances of QuickBooks are running"** | More than one copy of QuickBooks Desktop is open. The Web Connector only connects when a single instance is running. | Close all QuickBooks windows. If needed, open Task Manager and end any extra `QBW32.exe` processes. Reopen QuickBooks once with a single company file, then retry **Update Selected**. |
| **QBWC1039: "Unique OwnerID/FileID pair value required"** *(also appears as "index cannot be zero")* | An Apideck application is already registered in the Web Connector with the same ID, so it won't add another. Both error messages are the **same problem**. | Re-downloading the `.qwc` alone won't fix this. **Remove** the existing Apideck app from the Web Connector, **delete** the connection in Apideck Vault, then recreate the connection, download a **fresh** `.qwc` + password, and add it again. |
| **Status stuck on "Unauthorized"** | The password and the `.qwc` file don't match. | Re-download the `.qwc` and copy the new password from the **same** download. Use them together. |
| **"Last result: Another update in progress"** | A previous sync is stuck in a stale state. | Close the Web Connector completely and reopen it, then run **Update Selected** again. |
| **Sync silently stopped / data looks stale** | The Web Connector was minimized, closed, or the machine slept/shut down. | Reopen the Web Connector and leave it running (not minimized). See **"Why did syncing suddenly stop, or why is my data a few days behind?"** below. |

### Common questions

**Why did syncing suddenly stop, or why is my data a few days behind?**

Almost always because the QuickBooks Web Connector isn't running: this is the single most common cause of "it stopped working," and it's a QuickBooks limitation. Keep the Web Connector open:

- **Don't minimize the Web Connector window.** Minimizing stops the automatic sync. The window can sit in the background behind QuickBooks, but it must stay open.
- **Don't close it or shut the machine down** if you want syncing to continue. If the computer sleeps, logs out, or powers off, the connection stops until the Web Connector is open and running again.

**I made a change in QuickBooks but don't see it in Apideck yet. Is something broken?**

No. With auto-run on (the default, every ~1 minute), the connection syncs on a short cycle in the background rather than instantly. If you create or change something and don't see it reflected right away, wait about a minute. That delay is normal, not a sign something is broken.

---

## Getting help

If you run into something not covered here, contact [Apideck Support](https://help.apideck.com/en/articles/7774658). For connection or authorization problems, it helps to include the Web Connector log: in the Web Connector, click **View Log**, scroll to the **bottom** for the most recent entries, and share those (the log can be very long, and only the latest entries are useful).


[API reference](https://developers.apideck.com/apis/accounting/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/accounting/coverage)