Back to Help Center
ClientSynq

QuickBooks

Connect QuickBooks

Last updated: October 11, 2026

ClientSynq reads your customers, invoices and payments from one QuickBooks Online company. You connect, reconnect and disconnect it on one page: Settings → QuickBooks connection and sync. Every page that works with QuickBooks (the Dashboard, Client Invoicing, the QuickBooks Online Tools and Budget Reports) shows a compact status strip at the top right with a Connect or Reconnect link to that page.

Before you start

  • Available on every plan.
  • The status strip and the connection card appear for the Owner and Administrator roles, and for any role with at least one QuickBooks Tools permission (Sync QuickBooks, Import to QuickBooks or Export from QuickBooks). The QuickBooks connection and sync settings card also needs Manage Integrations or Sync QuickBooks. See Create roles and set permissions.
  • To connect, reconnect or disconnect you must be the owner, have the Administrator role, or have a role with Manage Integrations (Roles page, Settings group). Anyone else who clicks Connect to QuickBooks returns to the settings page with the message "Only an owner or administrator can connect QuickBooks. Ask an administrator of your organization to connect it." A disconnect is refused with "Failed to disconnect: Only an owner or administrator can disconnect QuickBooks".
  • You need to sign in to QuickBooks Online as a user who can authorize apps for the company.

Connect

  1. Open Settings (select the identity block at the bottom left of the sidebar), then QuickBooks connection and sync. From any page, the Connect link in the QuickBooks status strip at the top right opens the same page.
  2. In the QuickBooks Online card, check that the status reads Not Connected.
  3. Click the Connect to QuickBooks button.
  4. Sign in to Intuit, choose your company and approve access.
  5. You return to QuickBooks connection and sync. The card now shows Connected.
  6. Click Sync QuickBooks to load your customers, invoices and payments now. Otherwise they load in the nightly sync. Sync Customers loads only the customer list. On every other page, Sync now in the status strip runs the same full sync.

Settings → QuickBooks connection and sync → QuickBooks Online card showing Connected with the Sync Customers, Sync QuickBooks and Disconnect QuickBooks buttons

ClientSynq asks QuickBooks for access to your accounting data. After you turn on online payments, it also asks for access to QuickBooks Payments. See Turn on online payments.

Reconnect

When QuickBooks stops accepting ClientSynq's saved access, the status strip shows an amber dot with QuickBooks needs reconnecting · Reconnect, and the card on QuickBooks connection and sync reads Reconnect QuickBooks with "QuickBooks stopped accepting our access. Reconnect to keep syncing." The nightly sync skips your organization until you reconnect.

  1. Click Reconnect in the status strip, or open Settings → QuickBooks connection and sync.
  2. Click the Reconnect QuickBooks button in the card.
  3. Sign in to Intuit and approve access for the same company.
  4. You return to QuickBooks connection and sync with the status Connected.

If you pick a different company than the one you connected before, ClientSynq stops and asks you to confirm. See Switch to a different QuickBooks company.

Disconnect

  1. Open Settings → QuickBooks connection and sync and click Disconnect QuickBooks. This is the only place with a Disconnect button.
  2. Confirm the message "Are you sure you want to disconnect QuickBooks?"
  3. A message confirms "QuickBooks disconnected successfully" and the page reloads with the status Not Connected.

ClientSynq revokes its access with Intuit and removes the saved connection. Customers, invoices and payments that already synced stay in ClientSynq but stop updating.

The QuickBooks Online Disconnected page (/quickbooks-disconnected) also confirms a disconnection. Its Sign In to Reconnect button takes you to sign-in, and you reconnect from QuickBooks connection and sync as described above.

QuickBooks Online Disconnected page with the Sign In to Reconnect and Learn More buttons

Good to know

  • One organization connects to one QuickBooks company. To work with a second company, create another organization with Create New Organization on the Billing & Plans page and connect it there.
  • If you cancel on Intuit's screen, you return to QuickBooks connection and sync with the message "QuickBooks was not connected: the authorization was cancelled before it finished. Click Connect to QuickBooks to try again." Click Dismiss to hide it.
  • Finish the Intuit sign-in within 5 minutes of clicking the button. If you take longer, start again.
  • You can start a connection up to 10 times an hour. After that you see "Too many requests. Please try again later."
  • When the card shows an Enable QuickBooks Payments button, QuickBooks is connected without payment access. See Turn on online payments.