Skip to main content

How to connect QuickBooks Online to WorkZen

ZenGrow & ZenAIBeginner5 minutesUpdated August 15, 2026

Go to Settings > Integrations > QuickBooks Online, click Connect, and authorize WorkZen in the QuickBooks popup. Then map your tax rates to QuickBooks tax codes and your financial data starts syncing automatically.

Connecting QuickBooks Online means your invoices, payments, estimates, and clients land in your books without retyping anything. You run the business in WorkZen; QuickBooks stays current on its own.

Connect your account

Connecting requires the Manage Integrations permission; company admins have it by default.

  1. Go to Settings > Integrations and open QuickBooks Online.
  2. Click Connect.
  3. A QuickBooks authorization popup opens. Sign in with your QuickBooks Online credentials and approve the connection. This takes a moment, and the page confirms with "QuickBooks connected successfully".

WorkZen checks that your QuickBooks account uses the same currency as your WorkZen company. If they differ, the connection is blocked with a currency mismatch notice, because mixing currencies would produce incorrect financial data.

Map your tax codes

Right after connecting, WorkZen asks you to map each of your tax rates to a QuickBooks tax code, so taxes on synced invoices match your books exactly.

  1. For each WorkZen Tax, pick the matching QuickBooks Tax Code.
  2. Click Auto-Match to apply suggested mappings; suggestions are marked so you can review them.
  3. Click Save Mappings.
Warning

Skipping tax mapping is allowed, but invoices with unmapped tax rates may fail to sync until the mapping is complete. If a tax code you need does not exist in QuickBooks yet, create it there first, then click Refresh on the mapping screen.

WorkZen re-checks your mappings nightly. If tax codes change on either side, the integration page shows a "Tax Mapping Needs Review" banner with a Review Mappings button.

After you connect

The integration page becomes your sync dashboard:

  • Connection Status shows your QuickBooks Company ID, when it was connected, and a Test Connection button.
  • Sync Status shows synced, pending, and failed counts, with Sync Now and Retry Failed actions.
  • Open QuickBooks jumps straight to your QuickBooks account.

From here, everything is automatic. For exactly what flows across and when, see What syncs between WorkZen and QuickBooks.

Step by step

  1. 1

    Open the QuickBooks integration page

    Go to Settings > Integrations and open QuickBooks Online.

  2. 2

    Click Connect

    A QuickBooks popup opens. Sign in to your QuickBooks Online account and authorize WorkZen.

  3. 3

    Map your tax codes

    Match each WorkZen tax rate to its QuickBooks tax code. Use Auto-Match to apply suggested mappings, then save.

  4. 4

    Confirm the connection

    The page shows Connection Status with your QuickBooks Company ID, and syncing begins automatically.

Frequently Asked Questions

QuickBooks Online. Desktop editions of QuickBooks are not supported.
Your WorkZen account currency and your QuickBooks account currency must match. Syncing across different currencies would corrupt your financial data, so WorkZen blocks the connection. Connect a QuickBooks account that uses the same currency as your WorkZen company.
Yes, but invoices that use unmapped tax rates may fail to sync until you finish the mapping. You can complete it any time from the QuickBooks integration page under Tax Mappings.
QuickBooks authorizations expire or can be revoked from the QuickBooks side. Click Reconnect on the integration page to authorize again and syncing resumes where it left off.
Syncing stops immediately. Nothing already synced to QuickBooks is deleted, and your WorkZen data is untouched. You can reconnect later.

This article answers:

  • How do I connect QuickBooks to WorkZen?
  • Does WorkZen integrate with QuickBooks Online?
  • How do I set up QuickBooks sync?
  • Why is my QuickBooks connection failing?

Related articles

What syncs between WorkZen and QuickBooksExactly which records flow from WorkZen to QuickBooks Online, how fast, what the sync statuses mean, and how to fix a failed sync.3 min readHow to import QuickBooks customersPull your existing QuickBooks Online customers into WorkZen as clients in one click, with automatic duplicate protection.2 min readHow To Create And Send An Invoice in WorkZenCreate an invoice, add line items from your price book or packages, and send it to your client by email with an online payment link.Video, 2:00How To Record A Payment in WorkZenRecord cash, check, e-transfer, card, and other payments against an invoice, including partial payments, and see exactly what's still owing.Video, 1:09

Still have questions?

Browse the help center, or jump in and see it for yourself. WorkZen is free to get started.

Back to Help Center