--- title: "Web Connector Troubleshooting Guide" slug: "web-connector-troubleshooting-guide" updated: 2026-03-27T18:00:29Z published: 2026-03-27T18:00:29Z --- > ## Documentation Index > Fetch the complete documentation index at: https://help.servicetitan.com/llms.txt > Use this file to discover all available pages before exploring further. # Web Connector Troubleshooting Guide ## Overview Find the most common Web Connector errors experienced when exporting transactions from ServiceTitan to QuickBooks and how to fix them. --- ### #### Who uses this feature - Administrators, office employees, managers, accountants, and bookkeepers - Applies to all business types - Applies to all trades #### Feature configuration - Account configuration is required to use this feature. Please contact [Technical Support](http://go.servicetitan.com/ask) for details. ## Things to Know > [!WARNING] > **Caution:** If you are not sure what your QuickBooks file setup is, contact your local Administrator or IT team. Failure to understand your setup can lead to more errors and longer troubleshooting. - If you’re looking for the solution to a specific error on this page, press **Ctrl + F**and search for it. - If you are setting up the Web Connector for the first time, [please review the Setup Guide](/v1/docs/web-connector-setup-step-1-download-and-install-connector). - Click the link next to this icon ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) to play a short instructional video. ## Example QuickBooks File Setups **Desktop Computer Setup** - This is the most basic and common setup. Here, QuickBooks and the Web Connector are downloaded and installed directly onto one local computer. **Remote Server Setup** - This is when QuickBooks is installed directly on a server and is only accessed by one person who connects remotely to (or “remotes into”) the server. **QuickBooks Database Manager:** - This is when QuickBooks is installed on a “server computer,” a Remote Server or Desktop Computer. Here, the QuickBooks file is shared on a local network that is accessed by many users. ## How to navigate the Web Connector 1. The Connections List shows all your current Web Connector connections and their status. File: The name of your QuickBooks file. 1. **Name:**This is the name of the connection between your QuickBooks file and ServiceTitan. You can have multiple connections, but they must each have a unique name. 2. **Status:**A green dot in the first column indicates that the connection is active. A red dot indicates that the connection is offline. 2. Web Connector errors will show at the bottom of the display. 1. For a history of all previous errors, click **Logs**. 3. To see what version you’re on, click **About**. ## First Steps to Try **Open QuickBooks and the Web Connector as an Administrator:** 1. Close the Web Connector and QuickBooks if they are open. 2. Right Click on the QuickBooks application and select **Run As Administrator.**![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) ****[[Watch video]](https://servicetitan-1.wistia.com/medias/wtvahm0atq) 3. Switch to **Single User Mode** in QuickBooks. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/od3twm8dpi) 1. See the following QuickBooks documentation for details about why this is needed: [https://quickbooks.intuit.com/learn-support/en-us/help-article/small-business-processes/features-available-tasks-perform-single-multi-user/L2OQW4SYg_US_en_US?uid=l1ck4n3z](https://quickbooks.intuit.com/learn-support/en-us/help-article/small-business-processes/features-available-tasks-perform-single-multi-user/L2OQW4SYg_US_en_US?uid=l1ck4n3z) 4. Sign Into the **Admin**user Account in QuickBooks. ![QuickBooks login screen prompting for username and password to access company file.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/web-connector-troubleshooting-guide-image-5o011hpg.png) 5. Run the Web Connector as an Administrator using the [desktop shortcut](https://servicetitan-1.wistia.com/medias/jumu9qcq5s) or the [Windows search feature](https://servicetitan-1.wistia.com/medias/xc8g9ahjw5). **Create a New Connection:** - If the Web Connector is not installed, [please follow these instructions](/v1/docs/web-connector-setup-step-1-download-and-install-connector). - Confirm the Web Connector is up to date. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/pdeuyumzdm) - Create a new connection to the already installed Web Connector. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/d01kmdsobg) ## Fix common Web Connector situations **Web Connector is crashing during export:** 1. Ensure the Web Connector is up to date. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/pdeuyumzdm) 2. Close the Web Connector and QuickBooks. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/1fcrx6k143) 3. Use **Windows Search** to find **Add or Remove Programs**. ![Windows search results showing 'Add or remove programs' with related options listed.](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/web-connector-troubleshooting-guide-image-8lsb7w9d.png) 4. Delete any old QuickBooks applications. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/tynmbibkl4) 5. Re-open QuickBooks. It should reconfigure itself automatically. 6. The old connection should be present. If it still isn’t working, create a new connection. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/d01kmdsobg) **ServiceTitan needs permission to access QuickBooks:** 1. Sign Into the **Admin** user Account in QuickBooks. 2. Switch to **Single User Mode** in QuickBooks. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/od3twm8dpi) 1. See the following QuickBooks documentation for details about why this is needed: [https://quickbooks.intuit.com/learn-support/en-us/help-article/small-business-processes/features-available-tasks-perform-single-multi-user/L2OQW4SYg_US_en_US?uid=l1ck4n3z](https://quickbooks.intuit.com/learn-support/en-us/help-article/small-business-processes/features-available-tasks-perform-single-multi-user/L2OQW4SYg_US_en_US?uid=l1ck4n3z) 3. Remove any old Certificates from QuickBooks. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/eig9e362ob) 4. Try exporting a batch or creating a new connection. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/d01kmdsobg) 5. Give ServiceTitan permission when the certificate pops up. ![](https://cdn.document360.io/961862ab-d0f2-4d91-bb62-a62ee8184eff/Images/Documentation/icon-play-circle-filled-white.png) [[Watch video]](https://servicetitan-1.wistia.com/medias/d01kmdsobg) **The connection is green in the Web Connector, but red in ServiceTitan settings:** This means the connection between QuickBooks and the Web Connector is being blocked by a Firewall or other security programs. Contact ServiceTitan [Support.](/v1/docs/contact-servicetitan-technical-support) ## Fix common Web Connector errors **Failed to connect QuickBooks: Error from QuickBooks: Could not connect to QuickBooks. Make sure that QuickBooks is open, and running under the same Windows user as the Web Connector.** | **Possible cause** | **Fix** | | --- | --- | | The web connector is not installed in the same location as the QuickBooks file. | Ensure your QuickBooks is installed to the same file path as the Web Connector. | **The request was aborted: Could not create SSL/TLS secure channel.** | **Possible causes** | **Fixes** | | --- | --- | | The Web Connector is not installed in the same location as the QuickBooks file. | Ensure your QuickBooks is installed to the same file path as the Web Connector. | | Your remote server is blocking the Web Connector. | Contact your remote server provider and request that they provide the Web Connector with appropriate permissions/access. | | Your QuickBooks version is no longer supported. | Ensure that your QuickBooks version is no more than 3 years old. | | Your computer’s operating system is no longer supported. | Ensure that your computer or server is not running on Windows 7 or earlier. | **We were unable to connect to the QuickBooks file. Please confirm the connection is online and the file is accessible. A retry will occur every 2 minutes.** | **Possible cause** | **Fix** | | --- | --- | | The QuickBooks file isn’t open. | Ensure that both the Web Connector and the QuickBooks file are open on your computer or server. | **Error from Quickbooks: This application has not accessed this QuickBooks company data file before. The QuickBooks administrator must grant an application permission to access a QuickBooks company data file for the first time.** | **Possible cause** | **Fix** | | --- | --- | | Your QuickBooks file hasn’t authorized ServiceTitan to have application permissions. | 1. Login to QuickBooks as an Administrator in Single User mode with the Web Connector open. 2. Once the certificate pop-up appears, select **Yes, always; allow access even if QuickBooks is not running**and click **Continue**. Navigate to **QuickBooks > Edit > Preferences > Integrated Applications > Company Preferences.**ServiceTitan should be listed with a checkmark. | **QuickBooks Web Connector Error: No connection can be made because the target machine actively refused it.** | **Possible cause** | **Fix** | | --- | --- | | You are using the 1.0 Web Connector which is no longer supported. | Download and install the latest version of the Web Connector. | **Error from QuickBooks: Another QB process is preventing us from establishing connection. Please close all QB processes in Windows Task Manager, and try again.** | **Possible cause** | **Fix** | | --- | --- | | Multiple instances of QuickBooks are open on the same device or many users are accessing QuickBooks simultaneously. | 1. Press **Ctrl + Alt + Delete** and select **Task Manager**. Close out any processes or tasks related to QuickBooks. 2. Login to QuickBooks as a Single User and open the Web Connector. | **Error: Remote error: Active connection was not found..Task...** | **Possibe cause** | **Fix** | | --- | --- | | ServiceTitan Web Connector is not open in your computer or the Web Connector is not online. | Check to make sure that the ServiceTitan Web Connector is open and it is online. | | If the connection is offline, it may be a timing issue. | Check [this website](https://www.time.gov/) to find out the Internet Time and make sure the time on the Web Connector matches the computer and server time. Having the time ahead or delayed by one minute may result in the Web Connector having a status of offline. | | If the connection is online, then QuickBooks file may have been moved to a different location. | Check to see if the QuickBooks file is in the same location as before when you initially set up the connection. If the connection and are not in the same location: - We recommend moving the file back to the same file location when the connection was initially set up. - Add a new Web Connector connection and deactivate the old connection. Once added, run through [Reconciliation Tools](/v1/docs/reconciliation-tools-customers-pricebook-vendors) | **You have to setup a QuickBooks Desktop file with an active connection on the Settings page** | **Possible cause** | **Fixes** | | --- | --- | | The QuickBooks file is not configured properly in ServiceTitan. | 1. Go to **Settings > Integrations > QuickBooks Desktop**. 2. Make sure the correct QuickBooks file is configured. | | Your batch is still connected to an inactive company file. | Either change the company file that the existing batch is tied to in SQL or create a new batch and add all the transactions into that bach. Then do the following: 1. Go to **Settings > Integrations > QuickBooks Desktop**. 2. Select the company file. 3. Go to a row and click **Edit**. 4. Click **Save** without making any changes. 5. Repeat steps 3-4 for each row in the company file. | ## Want to learn more? - See [QuickBooks Desktop Users - FAQ](/v1/docs/quickbooks-desktop-users-faq)