Gmail logoQuickBooks logoGmail to QuickBooks
AvailableNative · GmailNative · QuickBooks

Connect Gmail to QuickBooks with Well

Gmail attachments are parsed inside Well for vendor, amount, VAT, and due date, then the documents arrive at QuickBooks as drafts with the original message ID attached.

About Gmail and QuickBooks

Gmail logo
Gmail
Source

The Gmail integration turns your inbox into an automated invoice capture flow.

QuickBooks logo
QuickBooks
Target

The QuickBooks connection delivers documents into QuickBooks Online through its @qbodocs.

Why this pair

Most suppliers email PDF invoices; QuickBooks wants structured bills with vendor, amount, due date, and line items.

Connecting Gmail to QuickBooks through Well closes that loop without OCR plug-ins or browser extensions. Each Gmail attachment is parsed for vendor, totals, sales tax, and line items, resolved against the QuickBooks vendor list, and drafted as a new bill with the original PDF attached.

What Well does between Gmail and QuickBooks

  • One-way: Gmail into Well into QuickBooks
  • Sync mode: Real-time webhooks
  • Events arrive within a minute
Gmail logo
Trigger from Gmail
5 events · pick one
Well engine·recipe·When an invoice PDF arrives as an attachment
Source
from email · live webhook
Datadog Sarl
via Gmail
Invoice
When an invoice PDF arrives as an attachment
INV-2026-04-100 · 22 Apr 2026€1,284.00
Extract
6 fields read from Gmail
6 fields read
  • VendorDatadog Sarl
  • Invoice numberINV-2026-04-100
  • Issue date22 Apr 2026
  • Total€1,284.00
  • Tax€256.80
Enrich
against your historical record graph
5 fields added
  • Legal entityDatadog Sarl
  • Tax idFR12830146588
  • Domaindatadog.com
  • Ledger account6156 · Monitoring
Confidence97%
<55% refused5585% review85% auto-posts
Post
post as bills and receipts
Create a bill or receipt in QuickBooks
auto-posted
posted
  • TypeBill
  • VendorDatadog Sarl
  • Amount€1,284.00
  • Ledger6156 · Monitoring
  • Source docattached
  • Confidence97%
audit linkto QuickBooks
QuickBooks logo
Action in QuickBooks
1 compatible with this trigger
Create a bill or receipt in QuickBooks

What Well does with Gmail invoices on the way to QuickBooks.

01Featured

Capture supplier invoices from email

Well watches Gmail for attachments matching invoice patterns, extracts amount, VAT, supplier, and due date in Well, then forwards the PDF to QuickBooks's email-in inbox. The original message ID stays on the document so the audit trail traces from QuickBooks back to the email that delivered the invoice.

02

Route personal-card vs supplier receipts

Receipts arriving in Gmail from employee personal cards are kept on the expense-reimbursement path inside Well, while supplier invoices route to the supplier-bill path. The category is decided from the sender domain plus the invoice format, so the right document type lands at QuickBooks rather than a mixed pile.

03

Resolve a new vendor from the invoice header

When an invoice arrives from a vendor Well does not recognise, the header (legal name, tax ID, bank IBAN) is parsed and a vendor record is proposed inside Well. The matched document is then forwarded to QuickBooks with the proposed match so QuickBooks's OCR can resolve it on arrival.

04

Catch missing attachments before delivery

If an Gmail invoice references a credit memo or a delivery note that did not arrive, Well flags the missing attachment inside its own queue and holds delivery until you forward the supporting document. Documents reaching QuickBooks always carry their supporting paperwork.

10 signals and actions across Gmail and QuickBooks

  • When an invoice PDF arrives as an attachment

    Pulls from your Gmail inbox. Picks up emails matching has:attachment filename:pdf and runs the document through extraction. Forwarded to QuickBooks' @qbodocs.com email-in; QuickBooks creates a bill or receipt with vendor, date, and amount populated.

    Trigger·Invoice
  • When an email arrives from a sender domain already in your vendor list

    Pulls from your Gmail inbox. The vendor is matched against your existing company records. Forwarded to QuickBooks' @qbodocs.com email-in; QuickBooks creates a bill or receipt with vendor, date, and amount populated.

    Trigger·Invoice
  • When an email attachment is processed by Well

    Pulls from your Gmail inbox. Receipts, invoices, statements: any PDF attachment is read and captured into your records. Forwarded to QuickBooks' @qbodocs.com email-in; QuickBooks creates a bill or receipt with vendor, date, and amount populated.

    Trigger·Document
  • When an email arrives from a sender domain not yet in your vendor list

    Pulls from your Gmail inbox. Well prepares a new vendor record from the email and document headers for your confirmation. Forwarded to QuickBooks' @qbodocs.com email-in; QuickBooks creates a bill or receipt with vendor, date, and amount populated.

    Trigger·Invoice
  • When an email with a bill attachment is processed by Well

    Pulls from your Gmail inbox. Well's AI extracts the bill from the attached PDF and matches the vendor against your existing records. Forwarded to QuickBooks' @qbodocs.com email-in; QuickBooks creates a bill or receipt with vendor, date, and amount populated.

    Trigger·Invoice
  • When an email with an invoice attachment is received

    Pulls from your Gmail inbox. Well picks up any received email with a PDF attachment; forwarded headers are recovered automatically. Forwarded to QuickBooks' @qbodocs.com email-in; QuickBooks creates a bill or receipt with vendor, date, and amount populated.

    Trigger·Invoice
  • Attach the source document to the QuickBooks record

    Driven by emailed invoices, receipts, and notifications. The forwarded PDF is stored on the QuickBooks bill or receipt as the source.

    Action·Document
  • Route the record to the For Review tab

    Driven by emailed invoices, receipts, and notifications. The created bill or receipt lands in the QuickBooks For Review tab so your team confirms the expense account and bank match before posting. Well never writes the ledger entry itself.

    Action·Transaction
  • Create a bill or receipt in QuickBooks

    Driven by emailed invoices, receipts, and notifications. Well forwards the PDF to your @qbodocs.com address; QuickBooks creates a bill or receipt with vendor, date, and amount populated. QuickBooks picks the record type per document.

    Action·Invoice
Reference
Field mapping for GmailQuickBooks
10 fields across 2 record types, open to see the full table.

Invoice fields

7 fields flow from Gmail into QuickBooks.

Gmail fieldQuickBooks field
extracted.invoice_numberDocNumber
extracted.issue_dateTxnDate
extracted.due_dateDueDate
extracted.totalTotalAmt
extracted.subtotalLine.Amount
extracted.taxTxnTaxDetail
extracted.currencyCurrencyRef

Company fields

3 fields flow from Gmail into QuickBooks.

Gmail fieldQuickBooks field
extracted.vendor_nameDisplayName
extracted.vendor_domainWebAddr.URI
extracted.vendor_tax_idTaxIdentifier

Connect Gmail and QuickBooks in three steps.

  1. Gmail logo1

    Connect Gmail

    Click Connect with Google; Google asks which mailbox to scope and returns a refresh token and authorise read access to invoice and receipt PDFs from email attachments, plus the sender, subject, and date headers. Access tokens are exchanged and refreshed automatically before they expire, and the grant is revocable from your Google Workspace.

    • AuthConnect
  2. 2

    Map your accounts

    Well discovers the Gmail attachments matching your invoice pattern (invoice and receipt PDFs from email attachments, plus the sender, subject, and date headers) and the the QuickBooks For Review inbox. Tune the parsing prompt once on the first ten records; Well saves the mapping and applies it to every subsequent attachment above 85% confidence.

    • Auto-post above85% confidence
    • Overridemanual anytime
  3. QuickBooks logo3

    Connect QuickBooks

    Click Connect with QuickBooks; you approve the connection inside QuickBooks Online and authorise read-only discovery of your existing records so Well can match against them when forwarding documents. Access tokens are exchanged and refreshed automatically before they expire, and the grant is revocable from your QuickBooks Online.

    • AuthConnect
    • First syncup to an hour

How Gmail and QuickBooks stay secure with Well

Well calls Gmail with an OAuth 2.0 token scoped to read-only access. Gmail's consent screen lists the scopes before you approve; access tokens are exchanged and refreshed automatically before they expire. Well's storage region is configured per workspace regardless of where Gmail and QuickBooks host theirs.

OAuth 2.0Storage region per workspaceGDPR-aligned
Scopes Well requests
  • Read Gmail records

    Scoped to invoice and receipt PDFs from email attachments, plus the sender, subject, and date headers. No access to anything else in your Gmail account.

    granted
  • Deliver documents to your QuickBooks inbox

    Well forwards the extracted document to your QuickBooks email-in address; QuickBooks reads bills or receipts via email-in at the @qbodocs.com address, with vendor, date, and amount populated by QuickBooks from it and you review and post. No write credential to QuickBooks is requested.

    granted
  • Modify or delete Gmail records

    Not granted. Gmail is read-only on Well's side; the source of truth never moves.

    refused
  • Read other workspaces' data

    Encryption keys are per-workspace; another tenant's records are inaccessible by design.

    refused
Disconnect any time from Well settings or Gmail’s admin panel.

Frequently asked questions about Gmail and QuickBooks on Well

01How often does Gmail data sync to QuickBooks?
Gmail pushes events to Well in real time via webhooks, so most records land within a minute of the underlying action. Each event is matched immediately and reaches QuickBooks within a confidence window: above 85% it posts, 55-85% queues for review, below 55% is refused.
02How does Well match Gmail records to entries in QuickBooks?
Well parses each Gmail attachment into a structured invoice, then probes your QuickBooks ledger for an open bill or vendor with the same amount, due date, and supplier name. The probe ranks candidates by counterparty proximity, date window, and total match; above 85% it links the parsed PDF to the existing QuickBooks entry, otherwise the parsed invoice queues for sign-off with the candidates surfaced.
03Does Well handle multi-currency records between Gmail and QuickBooks?
Gmail carries the original transaction currency on every record and QuickBooks natively ledgers in multiple currencies. Well preserves the original amount, applies your QuickBooks chart-of-accounts conversion rules at posting time, and both the source and converted amounts ride on the document Well forwards to QuickBooks, so the QuickBooks entry you post keeps both sides of the trade.
04Can I customise which Gmail fields are sent to QuickBooks?
The default mapping turns every parsed Gmail attachment into a QuickBooks-shaped record (vendor, amount, due date, tax). From the integration settings page you can adjust the parsing prompt, force a vendor mapping, attach the original PDF on a specific QuickBooks field, or compute a tag from your connected data. Custom mappings are versioned so a change does not retroactively touch already-posted QuickBooks entries.
05What happens if I disconnect Gmail or QuickBooks?
Disconnecting Gmail stops the flow at the source. Well calls the Gmail OAuth revoke endpoint; the refresh token is invalidated and any in-flight access token is rejected on the next call. Anything you already reviewed and posted in QuickBooks is QuickBooks's own record and is untouched; Well never held a write credential to it. Records held for review in Well remain in the queue so you can finish them by hand. Reconnecting later resumes from the last successful sync, not from scratch.
06How does Well authenticate with Gmail and QuickBooks?
Gmail runs a manual OAuth 2.0 flow that you approve inside Gmail; Well receives a refresh token scoped to the resources it needs to read. For the delivery side, Well forwards the reconciled document to your QuickBooks email-in address once it clears the matching threshold; QuickBooks creates the draft record from it and you confirm and post it. Well holds no write credential to QuickBooks. Tokens are encrypted at rest and in transit under TLS 1.3. Gmail and QuickBooks together cover multiple regions; Well's storage region is configured per workspace.
Gmail logoQuickBooks logo

Connect Gmail to QuickBooks.

Connect both sides. Your first invoice flows from source to ledger in minutes.

  • Read-only scopes on Gmail
  • AES-256 at rest, TLS 1.3 in transit
  • GDPR-aligned
  • Revocable QuickBooks access in one click