Conductor basics
How does Conductor work?
How does Conductor work?
Conductor is a web service that securely connects your app to one or more QuickBooks Desktop instances. It provides a RESTful API and fully-typed client libraries that you can use to read and write data to/from QuickBooks Desktop.Behind the scenes, Conductor uses the QuickBooks Web Connector, which is a Windows SOAP-based program that comes preinstalled with QuickBooks Desktop on your end-users’ computers. This program always runs invisibly in the background, waiting for requests from Conductor. When you send a request to Conductor, it forwards the request to the Web Connector, which then forwards the request to QuickBooks Desktop. The response follows the same path in reverse. Between each of those steps, there are many layers of error handling, validation, and data transformation.Conductor abstracts away multiple layers of complexity, idiosyncrasies, and fragility of working with QuickBooks Desktop so that interfacing with this tragically outdated technology is as easy and wonderful as using Stripe’s API.
How do users set up the QuickBooks Desktop integration with Conductor?
How do users set up the QuickBooks Desktop integration with Conductor?
Conductor leverages a program called QuickBooks Web Connector, which comes preinstalled with all versions of QuickBooks Desktop and runs invisibly in the background on the Windows computer to maintain the connection. To connect, the QuickBooks Desktop users will step through Conductor’s authentication flow, which has them download a config file that Conductor generates, open it in the Web Connector, authenticate, and connect to Conductor (and thereby to your application). Here is a demo of the auth flow.
Pricing: How much does Conductor cost?
Pricing: How much does Conductor cost?
Conductor is priced at $49 per month for each active QuickBooks Desktop company file connection. A connection is considered active if both of the following conditions are met within the same monthly billing period:
- Conductor receives a heartbeat from the QuickBooks Desktop instance.
- Your application makes a Conductor API call to that connection.
- Connections using QuickBooks “sample company files” or QuickBooks “Trial installations” are free.
- Connections using data from an active production environment are not.
- If you have a connection to a production company file that you want to use only for testing and development, please contact support to request a free exemption.
Should I use Conductor or build the integration from scratch?
Should I use Conductor or build the integration from scratch?
Integrating with QuickBooks Desktop from scratch is a painful nightmare. It’s a decades-old API that hasn’t been modernized and is riddled with edge cases, idiosyncrasies, and bugs that are incredibly difficult to work with. Conductor solves all of these problems and takes only a fraction of the time to implement with none of the maintenance headaches. We have obsessed over the edge cases and performance. Beyond the significant time savings, Conductor preserves your team’s mental well-being.
API and integrations
Do you have an OpenAPI specification available for the API endpoints?
Do you have an OpenAPI specification available for the API endpoints?
Yes, our OpenAPI specification is available here. Additionally, our API reference documentation is generated from this spec and provides detailed descriptions and examples for every field and endpoint.
Does Conductor support webhooks? If not, what is your recommended approach for retrieving data and notifying users of updates?
Does Conductor support webhooks? If not, what is your recommended approach for retrieving data and notifying users of updates?
Conductor does not support webhooks because we cannot guarantee that the QuickBooks Desktop connection will be online at all times. Rather than risking developers expecting real-time notifications for every data change, we recommend triggering syncs based on explicit user actions in your UI. For example, Ramp surfaces a list of unsynced transactions and lets users initiate “Sync to QBD” whenever they are ready.For teams seeking webhook-like behavior, some smaller customers run a scheduled process (such as a cron job) that periodically queries their users’ QuickBooks Desktop data through Conductor. If the connection is offline, the process can fetch changes since the last successful sync once connectivity is restored. During offline periods, we suggest showing an error state in your app’s UI so users know to bring the connection back online. While polling can emulate a limited webhook, it introduces added complexity around communicating both data changes and error scenarios, and frequent polling can impact the user’s workstation if QuickBooks Desktop is running locally.
Data handling and security
Does Conductor use a cache layer between me and my end-users' QuickBooks Desktop?
Does Conductor use a cache layer between me and my end-users' QuickBooks Desktop?
No, every Conductor API call is a real-time direct request to/from QuickBooks Desktop. If you make a request when the end-user’s computer is off or QuickBooks Desktop is inaccessible, Conductor will return an error message with instructions for how the end-user can resolve the issue.By design, Conductor has no cache layer because it causes all sorts of problems when data is out-of-sync. E.g., you modify data on one end that has already been removed on the other.Ideally, the computer running QuickBooks Desktop is always on and accessible. If that is not possible for some end-users, this design has still worked well because if such an end-user triggers a sync while using your app, they likely did so from the same computer as where QuickBooks Desktop is already running.
Does Conductor store any of my end-users' QuickBooks Desktop data?
Does Conductor store any of my end-users' QuickBooks Desktop data?
No, Conductor does not retain any of your end-users’ QuickBooks Desktop data on a permanent basis. For operational purposes, API request logs, which includes QuickBooks Desktop data, are temporarily, securely stored in a SOC 2 and GDPR-compliant log manager for 15 days before permanent deletion. Access to these logs is strictly limited to authorized Conductor engineers, who use them solely for debugging, offering customer support, and product improvement purposes. This approach ensures both the confidentiality of your data and compliance with the highest standards of data protection.
Does Conductor support batch processing?
Does Conductor support batch processing?
No, Conductor’s APIs currently only support working with a single object at a time because QuickBooks Desktop itself only resolves requests serially. If you want to create 50 invoices, for example, you will need to call the create-invoice API 50 times. However, you can send multiple requests in parallel; for example, you can use
await Promise.all([ ... ]) in JavaScript with multiple requests, but you cannot send multiple requests in a single HTTPS request.QuickBooks Desktop and Web Connector
What is the QuickBooks Web Connector?
What is the QuickBooks Web Connector?
The QuickBooks Web Connector is a Windows program that comes preinstalled with QuickBooks Desktop that Conductor uses to securely communicate with QuickBooks Desktop. This program runs invisibly in the background on the end-user’s computer, waiting for requests from Conductor. The only time your end-user should see the Web Connector is when they first set up their QuickBooks Desktop connection with Conductor; other than that, it should be invisible to them.
What is a QuickBooks Desktop "company file"?
What is a QuickBooks Desktop "company file"?
In the world of QuickBooks Desktop, a “company file” is the main local file for all the financial data for a specific company. Typically, a QuickBooks Desktop user will have only one company file: the one they use to manage their business. However, some users manage multiple company files on one computer and actively switch between them. For example, an accounting firm might manage the books for multiple clients, each with their own QuickBooks Desktop company file.Each Conductor connection is tied to a specific company file. If you need to connect to multiple company files, you will need to create multiple end-users in Conductor, each with their own connection. See this guide for more information.
What versions of QuickBooks Desktop does Conductor support?
What versions of QuickBooks Desktop does Conductor support?
Conductor supports every version, variant, and edition of QuickBooks Desktop since 2018, including:
- QuickBooks Enterprise Solutions - any version or year
- Any edition: Accountant, Contractor, Manufacturing and Wholesale, Nonprofit, Professional Services, Retail.
- QuickBooks Premier (Plus) - 2018 or later
- Any edition: Accountant, Contractor, Manufacturing and Wholesale, Nonprofit, Professional Services, Retail.
- QuickBooks Desktop Pro (Plus) - 2018 or later
- QuickBooks Accountant Desktop (Plus) - 2018 or later
Is QuickBooks Desktop being discontinued?
Is QuickBooks Desktop being discontinued?
No, QuickBooks Desktop is not being discontinued. Intuit reported $2.775B in revenue) from the QuickBooks Desktop ecosystem in 2025, growing 5% year-over-year.
- Ongoing Support: Intuit continues to support all existing versions of QuickBooks Desktop for current customers.
- Continued Sales: Intuit is still actively selling “QuickBooks Enterprise”, the main version of QuickBooks Desktop tailored for medium to large businesses, to new customers.
- Product Changes: Intuit will soon cease sales of “QuickBooks Desktop Pro/Premier Plus” – a less popular variant primarily used by small family businesses – to new customers (existing customers will still be supported).
Compatibility and connectivity
Does QuickBooks Desktop need to be open for Conductor to connect?
Does QuickBooks Desktop need to be open for Conductor to connect?
No, QuickBooks Desktop does not need to be actively open, but it should!As long as the computer is powered on, Conductor can communicate with QuickBooks via the Web Connector, which runs as a background service. When Conductor sends a request, the Web Connector automatically launches QuickBooks Desktop, processes the request, and then closes it. The Web Connector also starts automatically when the computer boots, enabling this seamless interaction.However, QuickBooks Desktop is slow to open, and opening and closing it hundreds of times eventually causes strange Windows bugs. Hence, we strongly recommend keeping QuickBooks Desktop open continuously.
Important: Launching QuickBooks Desktop adds approximately 30 seconds to request processing time due to its startup process. For optimal performance, keep QuickBooks Desktop open and signed in to the correct company file while using Conductor.
Alternative: Keep QuickBooks Desktop Open Without a Company File
As mentioned, we recommend keeping QuickBooks Desktop open and signed in to a company file for the fastest response times. However, some end-users still prefer to keep QuickBooks Desktop closed on the connected computer. Common reasons include:- To avoid occupying a QuickBooks Desktop license seat
- To be able to temporarily sign in with the same QuickBooks user on another computer (we recommend creating a dedicated QuickBooks Desktop user for Conductor to avoid this need)
- To avoid having to sign out from this computer when using single‑user mode on another computer
Can I set up the Web Connector connection on more than one computer for the same company file?
Can I set up the Web Connector connection on more than one computer for the same company file?
Yes. If your team shares a single QuickBooks Desktop company file on your office network, you can install the Web Connector connection on more than one Windows computer. Each computer will have its own entry in the QuickBooks Web Connector and can sync with that same company file. Many teams do this as a backup in case one computer is turned off or unavailable.
Important: The company file must live in the exact same folder path on every computer. The Web Connector uses the full path to decide which company file should receive a request. If the company file path is different on any computer (for example, different drive letters or folder names), syncs will fail.Simple ways to keep company file paths the same across all computers:
- Map the shared folder to the same drive letter on all computers (e.g., all use
S:\Accounting\...). - Or open the file using the same network path on every computer (e.g.,
\\SERVER\Share\Accounting\MyCompany.QBW).
Best practice: Set up the connection on the Windows server that hosts the
company file. These servers typically run 24/7, which removes the need to
maintain connections on multiple workstations.
Can Conductor access QuickBooks Desktop instances when the user's computer is off?
Can Conductor access QuickBooks Desktop instances when the user's computer is off?
No, there is no way to access QuickBooks Desktop instances when the user’s computer is off because QuickBooks Desktop data is not stored online. Instead, QuickBooks Desktop is a local application that runs on a user’s computer. As a result, this means an active Conductor connection is always direct and real-time. Conductor intentionally avoids using a cache layer to prevent potential data conflicts when data is out-of-sync.While this may seem limiting to many developers, we find that typical QuickBooks Desktop users do not mind:
- User Availability: When a user is interacting with your application that syncs data with QuickBooks Desktop, they are typically at their computer anyway, which means that QuickBooks Desktop is accessible.
- User Control: Many QuickBooks Desktop users are protective of their data and prefer to manually initiate data syncs rather than rely on automatic background processes. This approach gives them greater control over their data and ensures that no syncs occur without their explicit consent.
Does Conductor support connections to multiple QuickBooks Desktop company files on the *same* computer?
Does Conductor support connections to multiple QuickBooks Desktop company files on the *same* computer?
Yes, please see this guide for more information.
What QuickBooks Desktop hosting providers does Conductor support?
What QuickBooks Desktop hosting providers does Conductor support?
A QuickBooks Desktop hosting provider is a company that hosts an end-user’s QuickBooks Desktop instance and company file on a remote server that employees access via a remote desktop connection.
Conductor works with any system that has QuickBooks Web Connector installed, which comes pre-installed with QuickBooks Desktop itself. For this reason, Conductor can support every QuickBooks Desktop hosting provider we have encountered to date.
Some hosting providers, such as Rightworks, do not allow QuickBooks to continue running when users disconnect from their remote desktop session. In these scenarios, the user must remain connected to the remote desktop anytime they want to sync with QuickBooks (via Conductor). However, we’ve found that this is not a burden for most users because connecting to their remote desktop to work with QuickBooks data is already part of their daily workflow.
Verified hosting providers
We have individually verified Conductor compatibility with the following QuickBooks Desktop hosting providers:Does Conductor support Rightworks (previously called Right Networks)?
Does Conductor support Rightworks (previously called Right Networks)?
Yes, Conductor is fully compatible with Rightworks. Users can establish the connection just as they would with a typical Windows instance running QuickBooks Desktop.However, there is an important consideration: Rightworks users must sign in to their remote desktop session each time they wish to sync with QuickBooks Desktop. This requirement exists because Rightworks terminates inactive instances once the connection is closed, preventing background processes from running when the user is signed out. Despite this, most users find this process manageable because signing in to Rightworks is a routine part of their workflow. It is worth noting that, based on our experience, remote QuickBooks Desktop hosts like Rightworks account for fewer than 2% of all QuickBooks Desktop companies.Please see this guide for setting up a Conductor connection with a Rightworks QuickBooks Desktop instance.