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

> ## Agent Instructions
> Hebno is an AI work platform for client research and delivery: chat, research runs with sources, deliverables (Word, PowerPoint, Excel, email), projects, a shared library, agents, Office add-ins, and integrations with Microsoft 365, Google Workspace, CRM, project delivery, ERP and finance systems.
> Use British English (organisation, not organization).
> Every feature and integration described in these docs is available. Describe it as documented.
> Hebno never writes to a connected system without a member confirming a card. Finance and ERP writes are drafts only.
> Do not discuss commercial terms. Direct commercial questions to support@hebno.com.
> Start with /index and /get-started/quickstart.

# QuickBooks

> Read QuickBooks Online customers, projects, invoices, estimates, time and reports in Hebno, and save time, draft invoices and estimates after you confirm.

The QuickBooks integration makes the books available in client work. Ask what a customer owes, how a project's income compares with its costs, or which estimates are still open, and Hebno answers from QuickBooks Online with each record cited. When a request implies a change, such as logging time or preparing an invoice, Hebno shows a confirmation card and writes to QuickBooks only after you confirm.

## At a glance

| | |
| - | - |
| **Connection** | Organisation connection, made by an owner or admin who connects one QuickBooks company. Members can link their own QuickBooks sign-in. |
| **Default access** | Read only. Financial figures are visible to owners and admins until you share them with teams. |
| **Attach** | Customers, projects, invoices, estimates, reports |
| **Search** | Hebno searches QuickBooks when a request mentions a customer, project, invoice, estimate, hours, balance or report |
| **Link** | A project links to a QuickBooks customer, a QuickBooks project, and a class |
| **Write** | Save time, prepare a draft invoice, prepare an estimate. Every write needs a person to confirm. |

## Before you start

You need:

* An owner or admin role in Hebno.
* A QuickBooks Online user who can authorise apps for the company, typically a **Company admin**.

### Permissions

| Scope | Why Hebno needs it |
| - | - |
| `com.intuit.quickbooks.accounting` | Read and write accounting data: customers, invoices, estimates, time and reports |
| `openid`, `profile`, `email` | Identify the connecting user |

Each connection applies to one QuickBooks company. To connect a second company, add another connection from the QuickBooks card.

> [!TIP]
>
> QuickBooks applies the signed-in user's permissions to every call. Connect with a user whose access matches what you want Hebno to access, and a request outside it returns a permission error rather than partial data.

## Connect QuickBooks

**1. Allow the integration**

Open **Admin → Connectors → Catalogue**, find **QuickBooks** under **Finance**, and set it to **Allow**.

**2. Connect the company**

Select **Connect** and sign in to QuickBooks. Choose the company and approve the request. Hebno shows the company name when the connection succeeds.

**3. Choose teams and data areas**

Under **Who can use it**, choose **All teams** or pick teams. Under **Data areas**, choose what members can see. See [Data areas](#data-areas).

**4. Set access**

**Access** is **Read only** by default. Choose **Read and write** to let members propose time, draft invoices and estimates.

The card shows **Connected** with the company name. The connection is renewed between requests. If QuickBooks ends it, for example after a long period without use, the card shows **Reconnect**.

### Link your own account

Members can link their own QuickBooks sign-in so writes are made in their name under their own QuickBooks permissions.

1. In Hebno, open **Settings → Connections**, find **QuickBooks** and select **Link your account**.
2. Sign in to QuickBooks and approve the request for the company.

When your account is linked, Hebno reads and writes as you, and you see only what your QuickBooks permissions allow.

## Data areas

Data areas control what members of the allowed teams can see through the organisation connection. They apply on top of what the connecting user can read in QuickBooks.

| Data area | Includes | Default |
| - | - | - |
| **Customers and projects** | Customers, projects, classes, status | All allowed teams |
| **Time** | Time activities by employee, customer, project and date | All allowed teams |
| **Financials** | Invoices, estimates, balances, Profit and Loss, Aged Receivables | Owners and admins |

![Admin connector panel showing who can use it, access and data areas](https://mintcdn.com/hebno/A7yItabWdPf4lOIs/images/org-connection.png?fit=max\&auto=format\&n=A7yItabWdPf4lOIs\&q=85\&s=8d965e9c74747db0c182b004d569b236)

An organisation connection with team access and data areas. Financial figures default to owners and admins.

To share financials with delivery leads, open the QuickBooks card in **Admin → Connectors**, select **Financials** and add the teams that should see them.

> [!NOTE]
>
> When a member has linked their own account, Hebno uses that member's QuickBooks permissions instead of the organisation connection. Data areas still apply, so a member never sees more through Hebno than both QuickBooks and your Hebno settings allow.

## What Hebno reads

| QuickBooks object | Fields Hebno uses | Typical questions |
| - | - | - |
| **Customer** | Display name, email, balance, parent customer | "What is Contoso Retail's open balance?" |
| **Project** (sub-customer) | Name, parent customer, status, balance | "Which projects do we have open for Contoso?" |
| **Invoice** | Number, customer, date, due date, total, balance, status, line items | "Which Contoso invoices are overdue?" |
| **Estimate** | Number, customer, date, expiration, total, status | "Is the Contoso pricing review estimate accepted?" |
| **Time activity** | Employee, customer, service item, date, hours, billable status, description | "How many billable hours did we log on Contoso last month?" |
| **Class** | Name, parent class, figures by class | "What did the advisory class earn this quarter?" |
| **Report** | Profit and Loss by customer or class, Aged Receivables | "Show the Profit and Loss by customer for the quarter." |

Reports come from QuickBooks as they are at the time of the request, so figures match what the finance team sees. Reads are live. Hebno queries QuickBooks when a request needs it. Only what a reply used is stored with the conversation as its sources.

> [!WARNING]
>
> Excerpts a reply uses, including balances and profit figures, become part of the conversation. Anyone you share the conversation with can read them.

## What Hebno writes

Every write appears first as a confirmation card. You can change any field before you select **Confirm**.

| Action | QuickBooks object | Fields on the card |
| - | - | - |
| **Save time** | Time activity | Employee, customer or project, service item, date, hours, billable, description |
| **Prepare a draft invoice** | Invoice, saved and not sent | Customer, date, due date, line items, quantities, rates, class, memo |
| **Prepare an estimate** | Estimate, saved and not sent | Customer, date, expiration, line items, quantities, rates, memo |

![Confirmation card for QuickBooks with editable fields](https://mintcdn.com/hebno/A7yItabWdPf4lOIs/images/card-quickbooks.png?fit=max\&auto=format\&n=A7yItabWdPf4lOIs\&q=85\&s=5cea1fcfba95815e7e185ee3f6213430)

A QuickBooks change pending confirmation. Nothing is written until you confirm.

A draft invoice or estimate is saved in QuickBooks without being emailed, so it is pending until a person reviews and sends it there. Hebno never sends an invoice or estimate, records a payment, voids or deletes a transaction, posts a journal entry, or changes customers, items, accounts or other settings.

```mermaid theme={"system"}
sequenceDiagram
  participant You
  participant Hebno
  participant QuickBooks
  You->>Hebno: Draft the October invoice for Contoso
  Hebno->>QuickBooks: Read unbilled time for the Contoso project
  QuickBooks-->>Hebno: 62 hours across 4 people
  Hebno-->>You: Confirmation card with lines and rates
  You->>Hebno: Confirm
  Hebno->>QuickBooks: Save invoice without sending
  QuickBooks-->>Hebno: Invoice saved
  Hebno-->>You: Done, with a link to the invoice
```

If you have linked your own account, the record is created as you. Otherwise it is created through the organisation connection, with the write recorded against you in **Admin → Logs → Integrations**.

## Link a project to QuickBooks

Linking marks which QuickBooks records belong to a project, so you can ask "what is unbilled?" without naming the customer.

1. Open the project and select **Brain**.
2. Under **Linked records**, select **Link record**, then **QuickBooks**.
3. Search and select a **customer**, a **project** under that customer, or a **class**. Link each record the engagement uses.

In chats tagged to the project, Hebno starts with the linked records for any billing, receivables or profitability question, and cards default to them. See [Linked records](https://hebno.com/docs/projects/linked-records.md).

## Use QuickBooks in chat

* **Attach**: open the **+** menu, choose **Sources → QuickBooks**, and pick a customer, a project, an invoice or a report. Or type `/` and choose **QuickBooks**.

* **Ask**: name the client, period or report in your request. For example:

  > Which Contoso invoices are more than 30 days overdue, and what do they total?

  > Show income and costs by customer for the quarter and flag any engagement under 30 percent margin.

  > Prepare an estimate for Contoso for a six-week operating model review.

* **Research runs** show a **Checking QuickBooks** step, with a chip for each record or report it read.

* **Agents** can read QuickBooks on a schedule, for example a Monday summary of overdue invoices. Writes an agent proposes appear in [agent approvals](https://hebno.com/docs/automate/agent-approvals.md) for review.

## Troubleshooting

| Symptom | Fix |
| - | - |
| The card shows **Reconnect** | QuickBooks ended the connection. Select **Reconnect** and sign in again. |
| The wrong company appears | Disconnect and connect again, choosing the right company at the QuickBooks prompt. |
| Financial figures are missing from answers | The member's team is not in the **Financials** data area. |
| A record returns a permission error | The connecting user's QuickBooks permissions do not include it. Reconnect with a user who can open it. |
| A large query returns part of the result | QuickBooks returns up to 1,000 rows per query. Narrow the request by date or customer. |
| Time is saved under the integration user | Link your own account under **Settings → Connections** so entries are saved as you. |

## Related

* [How integrations work](https://hebno.com/docs/integrations/index.md)
* [Permissions and access](https://hebno.com/docs/integrations/permissions-and-access.md)
* [Linked records](https://hebno.com/docs/projects/linked-records.md)
* [Xero](https://hebno.com/docs/integrations/xero.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.