Skip to main content

QuickBooks Desktop Authentication

To read and write data from and to QuickBooks Desktop through Agave, you need to install QuickBooks Web Connector on your PC. QuickBooks Web Connector is an Intuit application that enables web services to securely exchange data with QuickBooks Desktop.

Step 1: Install QuickBooks Web Connector

Download the latest version of QuickBooks Web Connector from this link. Follow the prompts in the download to complete the installation.

Step 2: Open Company File

Open the QuickBooks Desktop application and select "Open" for your company file.

Step 3: Open QuickBooks Web Connector

Open QuickBooks Web Connector. You can open it by searching for it in the Windows Start menu, or by selecting "File → App Management → Update Web Services" in QuickBooks Desktop.

Step 4: Download the Config File

Follow the steps outlined in Agave Link, and download the config file (e.g. agave-91ea77fe-24df-4de5-9cb9-12e1c7c9d517.qwc).

Step 5: Authorize the App


Before opening the config file, make sure you have the correct company file open in QuickBooks Desktop, otherwise you will authorize access to the incorrect company file.

To open the file in QuickBooks Web connector, double-click it or select "Add an Application":

QuickBooks Desktop will now show you an authorization screen. Press OK to continue.

In the next screen, choose "Yes, always." If you choose "No", you will need to manually sync your QuickBooks Desktop data every time you want to update your data. If you choose "Yes", Agave will sync your data every 15 seconds.

Select "Yes" and "Done" in the next two screens.

Step 6: Enter the Password


This password is only displayed to you once. We recommend you store it in a secure place.

Enter the password you see in Agave Link in QuickBooks Web Connector. Make sure that you save the password when prompted.

Step 7: Verify the Connection

Click "Verify Connection". After a few seconds (up to 90 seconds), you should see your QuickBooks Desktop company in the dropdown. If not, refresh the list until you do. If everything is set up correctly, you should see QuickBooks Web Connector sending requests to Agave API.

Step 8: Select your Company

Select your company and press "Confirm".