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

# Connecting QuickBooks Online

> Set up the QuickBooks Online integration to post payouts automatically

## Overview

Host Ledger connects to QuickBooks Online to post your payout transactions and sync your chart of accounts, classes, and vendors.

<Tip>You'll connect QuickBooks during onboarding when you first set up Host Ledger. The instructions below are for managing your connection after initial setup.</Tip>

## Setup

<Steps>
  <Step title="Open Settings">
    Navigate to **Settings** from the top menu, then go to **Integrations**.
  </Step>

  <Step title="Connect QuickBooks">
    Click **Connect QuickBooks**. You'll be redirected to Intuit's authorization page.
  </Step>

  <Step title="Authorize access">
    Sign in to your QuickBooks Online account and authorize Host Ledger. Once complete, you'll be redirected back to Host Ledger and the connection will show as active.
  </Step>

  <Step title="Automatic sync">
    Host Ledger immediately syncs your QuickBooks data:

    * **Accounts** — your chart of accounts (used for account mappings)
    * **Classes** — for per-property P\&L tracking (optional)
    * **Vendors** — for OTA vendor mappings on deposits
  </Step>
</Steps>

## Reconnecting

If your QuickBooks connection expires or is revoked:

1. Navigate to **Settings** from the top menu and go to **Integrations**
2. Click **Reconnect** next to QuickBooks
3. Complete the authorization flow again

<Warning>When your QuickBooks connection expires, payouts will fail to post with an authentication error. Reconnect promptly to resume posting.</Warning>

## Syncing QuickBooks data

Host Ledger syncs your accounts, classes, and vendors automatically when you connect. If you've added new accounts or classes in QuickBooks and need them in Host Ledger:

1. Navigate to **Settings** from the top menu and go to **Integrations**
2. Click **Sync** next to your QuickBooks connection

## Multi-Company

You can connect multiple QuickBooks companies under a single organization and route properties to different companies.

<Card title="Multi-Company Setup" icon="buildings" href="/docs/configuration/multi-company">
  Learn how to manage multiple QuickBooks companies.
</Card>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Token expired or authentication error">
    QuickBooks tokens expire periodically. Go to **Integrations** and click **Reconnect** to re-authorize.
  </Accordion>

  <Accordion title="Missing accounts in dropdowns">
    If recently-added QuickBooks accounts don't appear, trigger a manual sync from **Integrations**.
  </Accordion>

  <Accordion title="Posting fails with validation error">
    Ensure all required account and vendor mappings are configured. Check that the mapped accounts still exist and are active in QuickBooks.
  </Accordion>
</AccordionGroup>