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

# QuickBooks Online Time Tracking Integration

> Connect Beebole to QuickBooks Online: import customers, items, and employees into Beebole, then export time entries as QuickBooks time activities in one click.

Beebole's QuickBooks Online integration works in two directions. When you connect it, Beebole imports your QuickBooks structure — customers, items, and employees — so both systems share the same customers, items, and employees. From then on, you can export time entries to QuickBooks as time activities in one click. This simplifies invoicing, payroll, and financial reporting for your organization.

***

## How it works

When you enable the integration, Beebole imports your existing QuickBooks Online data: **Customers** and **Items** are created as projects in Beebole, and QuickBooks **employees** are created as Beebole people — assigned the default role you select during setup, as with the other integrations.

To export, you simply select a period: Beebole takes all time entries for that period and automatically creates the corresponding **time activities** in QuickBooks. After each export, Beebole shows an **Entries successfully exported** count, plus an expandable **Entries not exported** list if any entry failed — you can also verify the created time activities in QuickBooks.

<Info>
  Only time entries are exported to QuickBooks. Expenses are not synced — they are handled in Beebole only.
</Info>

***

## Setting up the QuickBooks integration

<Steps>
  <Step title="Open integration settings">
    Go to **Settings** > **Integrations** in your Beebole account, then select **QuickBooks** from the list.
  </Step>

  <Step title="Connect to QuickBooks">
    Click **Connect to QuickBooks**. A popup appears asking you to sign in to your QuickBooks Online account; follow the Intuit prompts to authorize Beebole. The popup closes automatically when the connection is complete.
  </Step>

  <Step title="Choose the default role">
    Select the **Default role for imported employees** to assign to the people imported from QuickBooks, as with the other integrations.
  </Step>

  <Step title="Enable integration">
    Toggle **Enable integration** on. This triggers the import: Beebole brings in your QuickBooks customers, items, and employees. The toggle is what starts the sync — the connection alone does not import anything.
  </Step>

  <Step title="Verify the connection">
    Once enabled, the QuickBooks integration shows as active in your integration settings, and the imported customers, items, and employees appear in Beebole. You can now export time entries to QuickBooks.
  </Step>
</Steps>

***

## Exporting data to QuickBooks

<Steps>
  <Step title="Open the QuickBooks integration">
    Go to **Settings** > **Integrations** and select **QuickBooks** from the list.
  </Step>

  <Step title="Select a period and export">
    Under **Select period to export**, choose the period you want to export and click **Export** — that's the only input needed. Beebole fetches the time entries for that period and automatically creates the corresponding time activities in QuickBooks.
  </Step>

  <Step title="Check the result">
    Beebole shows an **Entries successfully exported** count, and an expandable **Entries not exported** list if any entry failed. To confirm the export, you can also open QuickBooks and verify the time activities were created.
  </Step>
</Steps>

<Tip>
  Export after the approval cycle is complete for a given period, so the hours sent to QuickBooks are final.
</Tip>

***

## What data is synced

| Direction                        | Data                        | Result                                                                                                                                                      |
| -------------------------------- | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| QuickBooks → Beebole (at setup)  | **Customers** and **Items** | Created as projects in Beebole                                                                                                                              |
| QuickBooks → Beebole (at setup)  | **Employees**               | Created as Beebole people with the default role you select                                                                                                  |
| Beebole → QuickBooks (on export) | **Time entries**            | Created as time activities in QuickBooks, carrying the entry's billing rate, billable or non-billable status, and its comment as the activity's description |

<Info>
  Because Beebole imports the QuickBooks customers, items, and employees at setup, exported time activities stay linked to the right customers, items, and employees automatically — even when the matching customer or item sits at a different level of your Beebole project hierarchy. Expenses are not synced in either direction — they are handled in Beebole only.
</Info>

***

## Keeping customers and items in sync

While the integration is enabled, customers and items created or renamed in QuickBooks are reflected in Beebole automatically. To pull the latest changes on demand, go to **Settings** > **Integrations** > **QuickBooks** and click **Manual sync** under **Manually sync QuickBooks customers and items**.

***

## Disconnecting QuickBooks

To disconnect the QuickBooks integration, go to **Settings** > **Integrations** > **QuickBooks**, toggle **Enable integration** off, then click **Reset connection**. The **Reset connection** button is disabled while the integration is enabled, so you must turn the toggle off first. Previously exported data remains in QuickBooks — disconnecting only removes the ability to send new exports.

Disconnecting from the QuickBooks side works too: if you remove Beebole from your apps in QuickBooks, Beebole is notified and closes the connection cleanly — the integration shows as disconnected the next time you look at it in Beebole.

***

## Related content

<CardGroup cols={2}>
  <Card title="Costs and billing rates" icon="dollar-sign" href="/help/documentation/costs">
    Configure billing rates and track costs across your projects.
  </Card>

  <Card title="Projects and activities" icon="folder" href="/help/documentation/projects">
    Manage your projects, subprojects, and billing rates in Beebole.
  </Card>

  <Card title="Custom integrations" icon="code" href="/help/integrations/custom-integrations">
    Build your own integrations using the Beebole GraphQL API.
  </Card>

  <Card title="All integrations" icon="plug" href="/help/integrations/introduction">
    Explore all available Beebole integrations.
  </Card>
</CardGroup>

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Is the QuickBooks integration real-time?">
    Customers and services are synced automatically and kept up to date in real time. Time activities are exported manually — you choose the period and trigger the export when ready, giving you full control over what gets sent to QuickBooks.
  </Accordion>

  <Accordion title="Can I export the same date range twice?">
    No. Beebole blocks any export that starts on or before the last day you already exported, so you cannot resend an overlapping period. If you try, Beebole shows the error "You can only export entries from the last day of the period already exported." This prevents duplicate time activities in QuickBooks.
  </Accordion>

  <Accordion title="Does the integration work with QuickBooks Desktop?">
    No. Beebole integrates with QuickBooks Online only. QuickBooks Desktop is not supported.
  </Accordion>

  <Accordion title="How do I know if an export succeeded?">
    After an export, Beebole shows an **Entries successfully exported** count. If any entry failed, an **Entries not exported** list appears that you can expand to see the details. You can also open QuickBooks to verify the time activities were created.
  </Accordion>

  <Accordion title="Are expenses exported to QuickBooks?">
    No. Only time entries are exported, as time activities. Expenses are handled in Beebole only and are not synced to QuickBooks.
  </Accordion>

  <Accordion title="Do I need admin access in both Beebole and QuickBooks?">
    Yes. You need administrative privileges in Beebole to configure the integration, and sufficient permissions in QuickBooks to authorize the connection and receive data.
  </Accordion>
</AccordionGroup>