Sections11
Reading time8 min
EvidenceWorking integration

/api/integrations/quickbooks/*

A QuickBooks integration should move a reviewed invoice or bill into the right company without retyping every line. Dynamite Docs connects QuickBooks Online over OAuth, imports supported linked attachments into the Library, and creates an invoice or bill after you map the customer or supplier, products or accounts, and tax. Attach the stored source file when it is 25 MB or smaller, then confirm delivery status separately from entry creation.

Why QuickBooks Online needs a reviewed handoff

  • Downloading a PDF, renaming it, and keying the same totals into QuickBooks Online duplicates work the review screen already finished.
  • A first-pass extraction can misread a tax line or supplier name. Creating the entry before a person checks those fields pushes bad data into the company file.
  • Attachments and transaction creation are separate outcomes. A team needs to know whether the bill exists and whether the source file arrived.
  • Company choice, customer or vendor mapping, and tax codes belong to the destination. The connector must surface those choices before send.

How the QuickBooks Online connection works

Dynamite Docs logoDynamite Docs
The handoff
Supplier invoice: A QuickBooks Online billOpen QuickBooks from Apps. Connect and choose a company. Import a linked attachment or open a reviewed extraction. Map fields and prepare a preview. Send and verify delivery. Not extracted customer data.A REVIEWED DOCUMENT, CONNECTED TO YOUR WORKSOURCE DOCUMENTSupplier invoice🔍 Click to zoomDynamite DocsQuickBooksDestinationReview before delivery
  1. 01Open QuickBooks from Apps
  2. 02Connect and choose a company
  3. 03Import a linked attachment or open a reviewed extraction
  4. 04Map fields and prepare a preview
  5. 05Send and verify delivery
Map fields, then send the reviewed entry.
01

Open QuickBooks from Apps

Sign in on Starter, Pro, or Scale. Open Apps and choose QuickBooks Online. The workspace reports whether the Intuit app credentials are configured on the server before you start OAuth.

02

Connect and choose a company

Choose Connect QuickBooks Online, approve the Intuit grant for com.intuit.quickbooks.accounting, then select the company that should receive invoices and bills. Tokens are encrypted at rest with the same AES-GCM path used for other OAuth connectors.

03

Import a linked attachment or open a reviewed extraction

Use Receive to pull a supported PDF or image attached to an existing QuickBooks invoice or bill into the Library. Or open a saved extraction you already reviewed beside its source.

04

Map fields and prepare a preview

Choose invoice or bill, map the customer or supplier, product or account lines, and tax. Dynamite Docs builds a preview that expires in 15 minutes so a repeated send cannot create a duplicate from a stale form.

05

Send and verify delivery

Choose Send to QuickBooks Online. Confirm the created entry in the connected company. If you attached the stored source file (up to 25 MB), check attachment delivery status separately from entry creation.

What the QuickBooks connector can do

Dynamite Docs logoDynamite Docs
Inside the output
Supplier invoice: A QuickBooks Online billCompany OAuth: Intuit grant scoped to accounting; encrypted tokens. Attachment import: supported linked PDF or image into the Library. Invoice creation: mapped customer, lines, and tax after preview. Not extracted customer data.Extracted fieldsDOCUMENT SCHEMAcompany_oauthIntuit grant scoped to…attachment_importsupported linked PDF or image…invoice_creationmapped customer, lines, and tax…A QuickBooks Online billDESTINATION FIELDSCompany OAuthMap to your destination schemaAttachment importMap to your destination schemaInvoice creationMap to your destination schemaIllustrative mapping. Confirm the field names accepted by your destination.
Company OAuth
Intuit grant scoped to accounting; encrypted tokens
Attachment import
supported linked PDF or image into the Library
Invoice creation
mapped customer, lines, and tax after preview
Map fields, then send the reviewed entry.

The connector is a reviewed handoff into QuickBooks Online, not a full AP or AR suite:

Company OAuth
Intuit grant scoped to accounting; encrypted tokens
Attachment import
supported linked PDF or image into the Library
Invoice creation
mapped customer, lines, and tax after preview
Bill creation
mapped supplier, lines, and tax after preview
Source attachment
stored file up to 25 MB on the new entry
Delivery status
entry creation checked apart from attachment status

A realistic example

A bookkeeping team moving one freight bill into QuickBooks Online:

StepIn Dynamite DocsIn QuickBooks Online
ImportPull freight-bill.pdf from a linked bill attachmentSource file stays on the existing bill
ReviewConfirm vendor, bill number, tax, and total beside the PDFNo new entry yet
SendMap supplier and expense account, then Send to QuickBooks OnlineNew bill appears; attachment status checked next

What the QuickBooks connector does and does not do

Does

  • Connects a QuickBooks Online company over OAuth and encrypts the tokens.
  • Imports supported linked invoice or bill attachments into the Library for normal extraction.
  • Creates invoices or bills from a reviewed, mapped preview and can attach a stored source file up to 25 MB.

Does not

  • Does not approve payments, run bank reconciliation, or create inventory movements.
  • Does not invent customers, vendors, or tax codes that are missing in the company.
  • Does not treat attachment upload success as proof that the person accepted the accounting treatment.

Why the company boundary matters

QuickBooks Online is the system of record for the company you select. The connector only sends what you mapped after a human review.

Import and send share the same connection, so one revoke removes both directions.

Attachment status stays visible because a bill without its source PDF is a different failure than a missing bill.

Setup and delivery questions

Extraction guides

Related integrations

Document workflows it feeds

From the blog

Send one reviewed bill to QuickBooks Online.

Connect the company from Apps, map a test bill beside its source, send the preview, and confirm the entry and attachment status.

Can we save optional cookies?

Essential cookies keep you signed in. Optional analytics and masked session replays help diagnose errors. Change your choice in Cookie settings. Privacy policy.