Overview
To authenticate QuickBooks Desktop, you will need to:
Sign into your QuickBooks Desktop instance as the Admin
Download a QuickBooks Web Connector configuration file
Input your password into the QuickBooks Web Connector
This guide will walk you through each of those steps.
Prerequisites
Please confirm the below requirements prior to setting up the integration:
You are at the correct computer.
Ensure you perform these steps on the computer you want to set up the connection on.
If your instance uses QuickBooks Desktop on multiple computers, set up the connection on the server or computer that stays on most often or where you use QuickBooks Desktop most frequently.
You have downloaded the QuickBooks Web Connector.
You are able to login with the Admin account.
Instructions
Step 1: Ensure you have the QuickBooks Web Connector installed
You must have the QuickBooks Web Connector installed on your computer to proceed with the subsequent steps
It often comes with QuickBooks Desktop, so you may already have it
To check if you have it installed, search your laptop for QuickBooks Web Connector
If you do not think you have it installed, it does not hurt to re-install it
If you do not yet have it installed, follow Step 1: Install QuickBooks Web Connector in this Intuit guide
Proceed to the steps below
Step 2: Login to QuickBooks Desktop
Open QuickBooks Desktop on your computer
Select the company file you would like to connect to
Login using the Admin user
This is only required for the initial setup process. After the integration has been set up, you can switch back to your regular user role.
Step 3: Download the configuration file
Back in the linking flow, download the configuration file to your computer
Open the downloaded file, which will automatically open the QuickBooks Web Connector.
This can be done by finding the file in your Downloads and double clicking on it.
You do not need to save this file for the future. It can be deleted after it is the setup is complete.
The QuickBooks Web Connector will take a few seconds to load.
Navigate back to the linking flow and proceed to the next screen by clicking Next.
Step 4: Grant permissions in QuickBooks Web Connector
After opening the configuration file, a window will open in your QuickBooks Web Connector prompting you to connect (though it may take a few seconds). Click OK in the popup.
An additional access screen may appear if this is your first time authenticating. If it does, follow the steps below:
Select Yes, always; allow access even if QuickBooks is not running.
A pop-up may appear at this time. Confirm your selection by clicking Yes in the additional pop-up.
A new Login as: dropdown will appear, allowing you to select a user. Select the user who uses this computer.
Your connection will use the credentials of the user you select. If this user is signed in on another computer, then this connection will not work. Thus, it is important to select the user who uses this computer to avoid conflicts.
If you are unsure, select Admin.
Finish granting permissions by selecting Continue and then Done in the Access confirmation pop-up
The QuickBooks Web Connector will reappear and should resemble the below
Step 5: Enter your password in QuickBooks Web Connector
Navigate back to the linking flow and copy the password shown
Paste the password into the Password column in the QuickBooks Web Connector and click Enter on your keyboard.
A pop-up will then appear, select Yes in the pop-up
That's it! You can now hide the QuickBooks Web Connector by selecting the Hide button in the bottom right corner
Finish the setup process by navigating back to the linking flow and selecting Next
You will then see the below page in the linking flow. The connection could take up to a minute to establish. If it eventually fails, see the troubleshooting steps listed below.
Troubleshooting and FAQ
I am seeing a "QuickBooks already has a company file open error".
If you are seeing an error that resembles the screenshot above after granting permissions in the QuickBooks Web Connector, follow the steps below:
Force quit QuickBooks Desktop
Reopen QuickBooks Desktop, select the company file you'd like to connect, and login
Reopen the configuration file (step 4.1) and continue with the setup process.