> For the complete documentation index, see [llms.txt](https://docs.drivepoint.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.drivepoint.io/neo/data-connectors/quickbooks-online.md).

# QuickBooks Online

Connect QuickBooks Online: settings, Intuit sign-in, what connected looks like, sync, and limits.

{% hint style="warning" %}
Draft. Steps are checked against the product code, not yet against a running build. Screenshots are pending.
{% endhint %}

## What it is for

QuickBooks Online brings in your general ledger, profit and loss, balance sheet, and journal entries.

## Before you start

* You can sign in to the QuickBooks Online company you want to connect.
* A payment method is on file, if QuickBooks Online is a paid source on your plan.
* Pop-ups and redirects are allowed for Drivepoint.

{% hint style="info" %}
Not confirmed yet: whether the person connecting must be a QuickBooks admin.
{% endhint %}

## Connect

{% stepper %}
{% step %}

### Choose QuickBooks Online

Open **Data Sources**, choose **Connect**, then **QuickBooks Online**.
{% endstep %}

{% step %}

### Choose your settings

Set the fields below. Choose carefully: you can't change them later from the source page yet.
{% endstep %}

{% step %}

### Sign in with Intuit

Choose **Authorize & connect**. If QuickBooks Online is a paid source, choose **Charge & continue**, or **Continue** if the charge is already on your subscription. Then sign in with Intuit and approve Drivepoint.
{% endstep %}
{% endstepper %}

## Fields

| Field                              | Required | Notes                                                                                                                    |
| ---------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| Accounting method                  | Yes      | Accrual or Cash.                                                                                                         |
| Data start date                    | Yes      | How far back Drivepoint pulls QuickBooks history.                                                                        |
| Incremental lookback months        | No       | 1 to 24 months re-synced on each incremental refresh. Leave blank for the default.                                       |
| Income Statement dimension 1 and 2 | Yes      | None, Departments, Classes, Customers, or Vendors. If dimension 1 is None, dimension 2 is None too. The two can't match. |
| Balance Sheet dimension 1 and 2    | Yes      | Same choices and rules.                                                                                                  |

{% hint style="info" %}
Not confirmed yet: the start date a customer sees. The code default is 2020-01-01. The lookback value used when the field is left blank is also not established.
{% endhint %}

## You're done when

QuickBooks Online appears in **Data Sources**, and the first sync starts.

{% hint style="info" %}
Not confirmed yet: the exact status label right after you connect.
{% endhint %}

## Sync and refresh

* Drivepoint checks freshness against your accounting close, then on a daily clock.
* You can refresh from the source page.
* **Additional streams** on the source page turns optional QuickBooks data on or off. Changes apply on the next sync.

{% hint style="info" %}
Not confirmed yet: how many days after books close Drivepoint waits before calling the source stale.
{% endhint %}

## Known limits

* Settings you choose at connect are saved. Changing them later from the source page is not available yet.
* Paid source: Drivepoint asks you to confirm the charge before Intuit sign-in. Free sources and some existing accounts skip this step.
* You can disconnect QuickBooks Online from its source page.

## Next

Check that pulled data looks right. That page is not in this preview.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.drivepoint.io/neo/data-connectors/quickbooks-online.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
