---
title: Setup QuickBooks Online
url: https://docs.maxio.com/accounting/general-ledger-integrations/quickbooks/setup/setup-quickbooks-online
applies_to: Maxio Core
updated: 2026-11-17
---

# Setup QuickBooks Online

The QuickBooks Online Connector enables information to flow between your Maxio account and your QuickBooks Online account. Once connected, QuickBooks Online shares responsibility for managing your financial records, so the actions you take and the settings you manage in QuickBooks Online can significantly affect the information stored in Maxio.

## Before you connect

> **Important:** QuickBooks Integration must be enabled in your account by Maxio Support before you can connect. Contact <a href="mailto:support@maxio.com">support@maxio.com</a> to get started. If you plan to connect to a QuickBooks Sandbox account for testing, or a non-US version of QuickBooks Online, let Support know so they can enable your integration with the right settings in place.

Before your first sync, make these **QuickBooks Online** changes:

- **Disable Invoice Automation.** Since Maxio handles your invoice scheduling, turn off QuickBooks Online's automatic invoice creation to avoid duplicate invoices between the two systems.
- **Custom Transaction Numbers.** If Custom Transaction Numbers are enabled in QuickBooks Online, Maxio automatically disables this setting through the API during your first sync. No manual action is required.

## Connect to QuickBooks Online

Once your QuickBooks Integration is enabled and the changes above are made, connect the two systems. Until QuickBooks Online is connected, a **Connect QuickBooks Online** card appears at the top of the QuickBooks integration page, with one step, **Sign in to QuickBooks Online**. Your QuickBooks settings stay visible below the card, and the card disappears once the connection succeeds.

**To connect Maxio to QuickBooks Online**

1. Log in to QuickBooks Online as an Administrator.
2. In Maxio, navigate to **Admin** > **Integrations** > **QuickBooks**, then select **Connect to QuickBooks** on the **Connect QuickBooks Online** card. Intuit's sign-in opens in the whole browser window.
3. QuickBooks Online prompts you to log in, if you aren't already, then choose the company you want to connect and select **Next**. This screen and the next step happen on QuickBooks Online's own site, not in Maxio.

   ![Intuit company picker for choosing which company to connect](https://docs.maxio.com/content-images/accounting/general-ledger-integrations/quickbooks/setup/setup-quickbooks-online/24177623410573_im_QuickBooks_SelectCompany.png)
4. Confirm the connection by selecting **Connect**.

   ![Intuit consent screen connecting Maxio to a company, with the data-sharing terms and a connect control](https://docs.maxio.com/content-images/accounting/general-ledger-integrations/quickbooks/setup/setup-quickbooks-online/24177575995277_im_QuickBooks_ConnectCompany.png)
5. Maxio returns you to the QuickBooks integration page with a banner confirming the connection succeeded.

If the connection fails, Maxio shows a banner asking you to try again.

## Disconnect and reconnect

Connecting to QuickBooks Online authorizes Maxio to access your QuickBooks Online account. Changes to your users or user permissions in QuickBooks Online, among other events, can cause that authorization to fail. When that happens, disconnect and reconnect:

1. Open the QuickBooks integration settings from the QuickBooks screen or the Admin menu.
2. Select **Disconnect** in the top-right corner.

   ![QuickBooks Integration page header with the Sync Now, Disconnect, Clear Sync Dates and Update Settings buttons](https://docs.maxio.com/content-images/accounting/general-ledger-integrations/quickbooks/setup/setup-quickbooks-online/24177623191309_QBO_Disconnect.png)
3. Select **Confirm** to complete the disconnection.

   ![Disconnect dialog warning that syncing stops until the account is reconnected](https://docs.maxio.com/content-images/accounting/general-ledger-integrations/quickbooks/setup/setup-quickbooks-online/24177637684493_ms_QuickBooks_Disconnect.png)
4. Reconnect by completing the connection steps above.

## Only one QuickBooks connection at a time

Your account can connect to QuickBooks Online or QuickBooks Desktop, but not both at once. If you want to switch from one to the other, read <a href="https://docs.maxio.com/accounting/general-ledger-integrations/quickbooks/using/change-or-convert-your-quickbooks-connection" target="_blank" rel="noopener noreferrer">Change or Convert Your QuickBooks Connection</a> before taking action.

> **WARNING:** Don't connect more than one QuickBooks Online account to a single Maxio account. Maxio doesn't detect or prevent this, so doing so can corrupt data in both systems.

## What to expect next

Once connected, see <a href="https://docs.maxio.com/accounting/general-ledger-integrations/quickbooks/overview/understand-the-quickbooks-integration" target="_blank" rel="noopener noreferrer">Understand the QuickBooks Integration</a> for how Maxio and QuickBooks share data, and <a href="https://docs.maxio.com/accounting/general-ledger-integrations/quickbooks/sync/sync-quickbooks-data" target="_blank" rel="noopener noreferrer">Sync QuickBooks Data</a> for sync conditions and recommended sync frequency.
