> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nectarclimate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# QuickBooks Online

> Connect Bill Pay to QuickBooks Online for automated AP posting.

<Tip>Need help in this area? See [Bill Pay FAQ](/platform/bill-pay/faq) or email [support@nectarclimate.com](mailto:support@nectarclimate.com).</Tip>

The QuickBooks Online integration connects Nectar to your QuickBooks company through an **OAuth 2.0** authorization flow. After you authorize access, bills routed by your rules are posted as **Bill** objects (vendor bills) through the QuickBooks Online Accounting API.

## How the connection works

When you authorize, QuickBooks returns your company identifier (`realmId`) and OAuth 2.0 tokens, which Nectar stores as encrypted credentials. Nectar then creates each bill through the Accounting API `Bill` endpoint (`/v3/company/{realmId}/bill`). Each bill references the vendor (`VendorRef`) and posts one or more account-based expense lines (`AccountBasedExpenseLineDetail`) mapped to the correct expense account (`AccountRef`) from your [GL coding rules](/platform/bill-pay/rules), against your Accounts Payable account (`APAccountRef`).

## Set up in Nectar

<Steps>
  <Step title="Open the ERP wizard">
    Go to [**Bill Pay > Destinations**](https://dash.nectarclimate.com/bill-pay/destinations/new/integration), click **AP/ERP Integrations**, and select **QuickBooks Online**.
  </Step>

  <Step title="Authorize QuickBooks">
    Sign in to your QuickBooks Online account and authorize Nectar to create bills on your behalf. Nectar captures your company `realmId` and stores the OAuth 2.0 access and refresh tokens securely as encrypted destination credentials.
  </Step>

  <Step title="Add a routing rule">
    Create a [routing rule](/platform/bill-pay/rules) with **Route to AP integration** targeting your QuickBooks destination.
  </Step>
</Steps>

Unlike other ERP systems in the wizard, QuickBooks Online does not require manual entry of API host URLs or client secrets — the OAuth flow handles authentication.

<Note>
  If QuickBooks Online is not yet available in your environment, contact [support@nectarclimate.com](mailto:support@nectarclimate.com) to request access or share requirements for your QuickBooks setup.
</Note>

## What gets delivered

When a bill is routed to QuickBooks Online, Nectar posts a `Bill` object with the vendor reference, transaction and due dates, currency, and account-based expense lines coded to the expense accounts from your rules. Delivery status appears in the [bill audit trail](/platform/bill-pay/decisions).

## FAQ

<AccordionGroup>
  <Accordion title="Can I connect multiple QuickBooks companies?">
    Yes. Each QuickBooks company has its own `realmId`, so create a separate destination for each company you authorize and point routing rules at the destination that matches the bills you want in that company.
  </Accordion>

  <Accordion title="How do I reconnect if authorization expires?">
    Edit the destination from [**Bill Pay > Destinations**](https://dash.nectarclimate.com/bill-pay/destinations) and re-run the OAuth authorization flow, or contact [support@nectarclimate.com](mailto:support@nectarclimate.com).
  </Accordion>
</AccordionGroup>

## Related pages

* [ERP integrations overview](/platform/bill-pay/erp-integrations/overview)
* [Destinations](/platform/bill-pay/destinations)
* [Bill audit](/platform/bill-pay/decisions)