> ## Documentation Index
> Fetch the complete documentation index at: https://control-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect QuickBooks

> Authorize Control to read accounting data from a QuickBooks Online company.

export const ControlAppLink = ({path, breadcrumb, children}) => {
  const link = <a href={`https://app.control.dev${path}`} target="_blank" rel="noopener noreferrer" aria-label={breadcrumb ? `Open ${breadcrumb} in Control` : undefined}>
      {children}
    </a>;
  return breadcrumb ? <Tooltip tip={breadcrumb}>{link}</Tooltip> : link;
};

QuickBooks Online connects to Control through Intuit OAuth. Use an Intuit account with administrator access to the
company you want to connect.

## Connect in Control

1. Open <ControlAppLink path="/entities-data-sources/overview"><strong>Entities & sources</strong></ControlAppLink>.
2. Open the intended entity, choose **Add data source**, and select **QuickBooks**.
3. Give the data source a recognizable name.
4. Choose **Connect QuickBooks**.
5. Sign in with Intuit, select the intended QuickBooks company, and authorize Control.
6. Return to Control and confirm that the data source shows as connected.

Control stores the OAuth credentials and QuickBooks company ID securely. Tokens are refreshed automatically while the
authorization remains active.

## Permission requested

Control requests only `com.intuit.quickbooks.accounting`. Intuit uses this single scope for the QuickBooks Online
Accounting API, including both read and update operations; it does not offer a narrower read-only accounting scope.
Control only reads accounting resources and does not request `com.intuit.quickbooks.payment`, which is for processing
payments.

The person completing OAuth must be a QuickBooks company administrator. If an accounting firm connects on the
customer's behalf, use an authorized accountant account that has company-admin access rather than a temporary personal
login.

## Data imported

* General-ledger reports, journal entries, and chart of accounts
* Classes, departments, items, customers, and vendors
* Sales invoices, sales receipts, credit memos, and refund receipts
* Bills, purchases, vendor credits, and credit-card transactions
* Customer and bill payments, deposits, transfers, and tax payments
* Tax agencies, tax codes, and tax rates

## Common problems

* **The company is not available:** confirm that the signed-in Intuit user is a company administrator, then try again.
* **The wrong company was connected:** reconnect the data source and select the company that belongs to the Control entity.
* **The connection stopped working:** access may have been revoked in QuickBooks. Reconnect the data source in Control.

## Provider documentation

* [QuickBooks Online: connect and authorize an app](https://quickbooks.intuit.com/learn-support/en-us/help-article/integrations/connect-app-manage-app-settings-quickbooks-online/L7S4rtR7X_US_en_US)
* [Intuit OAuth documentation](https://developer.intuit.com/app/developer/qbo/docs/develop/authentication-and-authorization)
* [Intuit scope reference](https://developer.intuit.com/app/developer/qbo/docs/learn/scopes)