- Home
- QuickBooks integration
- Salesforce and QuickBooks
Salesforce to QuickBooks: a won deal becomes an invoice, and the payment comes back
A Salesforce QuickBooks integration turns a won opportunity into a QuickBooks Online invoice, then writes the payment status back onto the Salesforce account. You can run it through MuleSoft's QuickBooks Online Connector, an app, or a custom build on both APIs. Each route meets the same QuickBooks rules: customer names must be unique, customers are written one at a time, and every write needs a request ID so a retry can't double an invoice.
Five Salesforce records map to five QuickBooks records
Intuit’s invoice guide sets the floor: every QuickBooks invoice needs a customer and at least one line, and only one customer. Intuit also says to create the records a transaction refers to first, then point to them.
Scroll the table sideways to see every column.
| Salesforce record | QuickBooks Online record | The rule that bites |
|---|---|---|
| Account | Customer | Names must be unique (error 6240), and customers nest at most 5 levels deep |
| Product and price book entry | Item | The item must exist in QuickBooks before an invoice line can use it |
| Opportunity, won | Invoice | One customer per invoice, at least one line |
| Quote | Estimate | Sync the accepted quote to the opportunity before the deal is won |
| Payment status | Payment, linked to the invoice | QuickBooks ties a payment to its invoice through LinkedTxn |
Sales orders are a special case. Intuit opens its Sales Order API only to app makers on the Gold and Platinum tiers. A link without that tier goes straight from the won deal to the invoice.
Which Salesforce event should create the invoice
Use the opportunity’s won flag, not a stage name. Salesforce says a change to StageName also updates IsClosed, IsWon and Probability, from your stage mapping. So a rule on IsWon keeps working when someone renames a stage.
The invoice lines should come from the synced quote. Salesforce’s SyncedQuoteId field names the quote that syncs with the opportunity, and a quote’s IsSyncing field shows whether it is the one. Make sure the accepted quote is the synced one before the deal is marked won.
There are two ways to notice the win:
- Change events. Salesforce publishes opportunity changes on the /data/OpportunityChangeEvent channel. It keeps those events for three days, so a link that goes down for a weekend can catch up.
- Polling. Salesforce’s Get Updated resource lists records changed in a time range. It is simpler, and slower. Deleted records go to a delete log that Salesforce purges from time to time, so read it often.
Three QuickBooks rules that break simple syncs
Plan for each one before the first record moves.
- One name, one customer. QuickBooks rejects a duplicate name with error 6240, Duplicate Name Exists. If two Salesforce accounts share a name, the second one fails. Match on a stored ID before you match on name.
- Customers go in one at a time. Intuit says updates and additions to list records, such as customers, must be made one after another. Its batch call is for transactions, not for customers, vendors or items. So the first load of your accounts runs in single file.
- Every write carries a request ID. Intuit says a request ID on each write makes it idempotent, meaning a retry does the job once. Without one, a retried create makes a duplicate invoice with a new ID. The ID holds up to 50 characters.
Closed books add a fourth trap. Error 6200 means someone closed the period, so QuickBooks refuses edits to it. A sync that back-dates invoices into a closed month will fail. Agree a rule with your accountant first.
Keep each system’s ID in the other
Store the QuickBooks ID on the Salesforce record. Salesforce can create or update a record by the value of an external ID field, which Salesforce calls an upsert. A QuickBooks customer ID in an external ID field on the account lets the sync update the right account every time.
The other direction needs a paid Intuit partner tier. Intuit’s Custom Fields API, which can create up to 12 custom fields, is a premium API. Intuit opens premium APIs only to app makers on the Silver, Gold and Platinum tiers, and only the Builder tier is not charged. Without that tier, keeping the ID map on the Salesforce side is the simpler choice.
The QuickBooks rules stay the same on all three routes
What changes from route to route is who runs the link.
- MuleSoft. MuleSoft documents a QuickBooks Online Connector, and its docs carry a Salesforce, Inc. copyright. They name syncing QuickBooks Online data with Salesforce accounts and customers as a common use. It signs in with OAuth 2.0. Its reference lists operations to get and create estimates and invoices. Version 2.0.22, dated September 4, 2026, targets QuickBooks API 75.
- An app. An app listed on Intuit’s QuickBooks App Store must pass Intuit’s three-part review first. You work within the app’s own record map. We did not review Salesforce AppExchange apps for this page.
- A custom build. Code calls both APIs and follows your map. On the Salesforce side, it signs in as an external client app or a connected app, over OAuth 2.0. Salesforce restricted new connected apps from Spring ’26 and recommends external client apps.
Our QuickBooks integration page compares these routes in more depth, including Intuit’s API limits.
An agent can settle the records the sync rejects
Salesforce now sells its own quote tools. Salesforce says Revenue Cloud puts pricing, quoting, contracting and billing on one data model. Salesforce also says Revenue Cloud with Agentforce can generate, update and send a quote. If you bill from Revenue Cloud, the QuickBooks link changes shape, so decide where invoices live before the build.
The sync’s rejects are a good first job for an agent. When QuickBooks refuses a customer with error 6240, an agent can compare the two Salesforce accounts, find the QuickBooks customer that already holds the name and propose a match for a person to approve.
Our team has built Salesforce agents for six jobs, some in Agentforce and some as custom agents. One of them is quote to cash: the agent turns an accepted quote into an order and passes it to your ERP or billing system for the invoice.
Read Salesforce AI agents for those jobs, and Agentforce, Joule, Breeze or a custom agent to choose between Salesforce’s agents and a custom one.
Questions
How do I connect Salesforce to QuickBooks Online?
Pick one of three routes. MuleSoft's QuickBooks Online Connector links the two if you already run MuleSoft. An app from Intuit's QuickBooks App Store works within that app's own record map. A custom build signs in to both systems with OAuth 2.0 and follows your record map. All three need the same groundwork: unique customer names, matched items and a rule for which Salesforce event makes the invoice.
How to input sales tax into QuickBooks from Salesforce?
Let QuickBooks do it, or send the amount you quoted. US QuickBooks Online companies made after November 10, 2017 use Intuit's automated sales tax engine, which works out tax from addresses on the sale. If your Salesforce quote already holds the tax, Intuit says an app can send that figure in a field called TotalTax, and QuickBooks honors it. Sales tax itself must be turned on in QuickBooks, because the API can't turn it on.
Can Salesforce orders become QuickBooks sales orders?
Only on Intuit's higher partner tiers. Intuit added a Sales Orders API in its September 2026 release notes. Its docs open that API only to app makers on the Gold and Platinum tiers of its partner program. Without that tier, a link creates the invoice straight from the won deal. If you need the order stage in your books, ask whether your integration vendor holds one of those tiers.
Will the sync create duplicate customers in QuickBooks?
It will try to, unless you match first. QuickBooks rejects a second customer with a name already in use, with error 6240, Duplicate Name Exists. If Salesforce holds two accounts with the same name, such as two branches of one firm, the second one fails. So the sync needs a rule: match on a stored QuickBooks ID first, then on name, and send clashes to a person instead of retrying.
Can reps see QuickBooks payments in Salesforce?
Yes. In QuickBooks, a payment links to its invoice through a field called LinkedTxn. Intuit's webhooks tell an app when data changes in a connected company, and Intuit's change data capture call can catch anything missed in the last 30 days. The sync reads the payment, finds the invoice and writes the paid status back to the Salesforce opportunity or account.
Do we need MuleSoft for a Salesforce QuickBooks link?
No. MuleSoft is one route. Its QuickBooks Online Connector suits a company that already runs Mule apps for other links. Version 2.0.22, dated September 4, 2026, lists QuickBooks API 75 and Mule runtime 4.3.0 or later. A company without MuleSoft can use a custom build or an app instead. The QuickBooks rules on this page apply to all of them.
Sources
Every source behind a figure or a vendor fact on this page, with the day we read it.
- MuleSoft, QuickBooks Online Connector 2.0Read 18 Nov 2026
- MuleSoft, QuickBooks Online Connector release notesRead 18 Nov 2026
- MuleSoft, QuickBooks Online Connector referenceRead 18 Nov 2026
- Salesforce, Object Reference (Winter '27)Read 18 Nov 2026
- Salesforce, REST API Developer Guide (Winter '27)Read 18 Nov 2026
- Salesforce, Change Data Capture Developer GuideRead 18 Nov 2026
- Salesforce, Revenue Cloud overviewRead 18 Nov 2026
- Intuit Developer, error codesRead 18 Nov 2026
- Intuit Developer, basic ID and field definitionsRead 18 Nov 2026
- Intuit Developer, what you can do with the QuickBooks Online Accounting APIRead 18 Nov 2026
- Intuit Developer, create basic invoicesRead 18 Nov 2026
- Intuit Developer, App Partner Program FAQRead 18 Nov 2026
- Intuit Developer, premium APIsRead 18 Nov 2026
- Intuit Developer, sales ordersRead 18 Nov 2026
- Intuit Developer, general release notesRead 18 Nov 2026
- Intuit Developer, manage linked transactionsRead 18 Nov 2026
- Intuit Developer, webhooksRead 18 Nov 2026
- Intuit Developer, change data captureRead 18 Nov 2026
- Intuit Developer, what to expect during the app reviewRead 18 Nov 2026
- Intuit Developer, automated sales tax (US locales)Read 18 Nov 2026
Map your Salesforce deals to QuickBooks invoices
Tell us your Salesforce edition, your QuickBooks edition and the stage that should make an invoice. The first call is free.