Overview
Dirt Face syncs with QuickBooks Online (QBO) only — not QuickBooks Desktop. Most sync issues are connection expiry, invoice status, or duplicate customer matching.
Open: QuickBooks integration
Setup guide: Connect QuickBooks Online
Connection expired or disconnected
Intuit tokens expire periodically or after password changes.
- Go to Business Settings → Integrations → QuickBooks
- Click Reconnect (or Connect to QuickBooks)
- Sign in to Intuit and re-authorize Dirt Face
- Confirm the correct QBO company file is selected
Important: Only one QBO company can link to each Dirt Face tenant at a time.
Invoice not appearing in QuickBooks
| Check | Detail |
|---|---|
| Invoice status | In Dirt Face the invoice must be Sent — drafts do not sync |
| Sync toggles | On the integration page, confirm Invoices sync is enabled |
| Customer linked | Invoice customer must exist or sync to QBO first |
| Plan | QuickBooks integration requires Growth plan or higher |
Create/send flow: Create and send invoices
Customer duplicated in QuickBooks
On first sync, Dirt Face may create a new QBO customer when names differ slightly.
| Fix | Steps |
|---|---|
| Match existing | When prompted during sync, choose Match existing QBO customer |
| Clean up manually | Merge duplicates in QBO, then keep naming consistent in Dirt Face going forward |
| One customer record | Use the same company name and email in Dirt Face as in QBO |
Payment not syncing
Confirm Payments sync is enabled on the integration page. Payments applied in Dirt Face after reconnect may need to be re-entered if they occurred while disconnected.
Tax or total mismatch
Compare:
- Sales tax rates in Dirt Face vs QBO
- Tax-exempt flags on the customer record
- Line item quantities after invoice edits post-send
Edit the invoice in Dirt Face before re-sending if totals are wrong; already-synced invoices may need adjustment in both systems.
“Integration not available” or missing tab
- Confirm subscription is Growth+
- Only admins can connect integrations
- Refresh Business Settings after a plan upgrade
After disconnecting QuickBooks
Previously synced records stay in both systems, but new changes do not sync until you reconnect. Do not disconnect casually during active billing.
Still failing?
Note the invoice or customer name, approximate sync time, and any red error banner on the integration page, then contact support.