QuickBooks

Connect QuickBooks Online so Fours AI can look up and work with your accounting records — customers, invoices, payments, items and reports.


Overview

QuickBooks Online is Intuit’s cloud accounting platform for invoicing, payments and financial reporting. Connecting it gives Fours AI agents a set of QuickBooks tools: they can answer questions from your books (“which invoices are overdue?”, “what was last quarter’s profit and loss?”) and, with the right access, create and update customers and invoices, email an invoice, record a payment, or void and delete invoices. Category: Accounting.

Each connection reaches exactly one QuickBooks company — the one you choose when you authorize — and every tool works only on that company.

Org-Level vs User-Level

Org-Level: Supported. A Fours admin connects one QuickBooks company for the whole organization, by OAuth. Organization agents that an admin gives QuickBooks to use it, with the access of the Intuit user who authorized it.

User-Level: Supported. Each person connects their own QuickBooks access by OAuth, and their own agents and the Insulin assistant use it.

Both levels use the same sign-in and offer the same tools; they differ only in who can use the connection. See Integrations and Knowledge Bases for which agents use which level.

How the connection works

You sign in to Intuit through Fours, choose a company, and approve access. Fours holds and refreshes the resulting token; you never give Fours a QuickBooks password or set up an Intuit developer app of your own.

Create Integration (Org-Level)

Prerequisites

  • A QuickBooks Online company, and an Intuit sign-in that can access it. For the org-level connection, prefer an account that will stay with the company: if the person who authorized it loses access to the company in QuickBooks, the connection stops working and must be reconnected.
  • The Fours Admin role — connecting and disconnecting an org-level integration is admin-only.

Authenticate by OAuth

  1. In the Fours console, open Settings → Integration and click Connect on the QuickBooks card.
  2. In the dialog, click Start connection. Intuit’s authorization window opens.
  3. Sign in to Intuit, choose the QuickBooks company you want to connect, and approve access.
  4. The dialog finishes the connection on its own, and the card shows QuickBooks as connected. If you closed Intuit’s window before finishing, click Re-open QuickBooks window in the dialog.

Create User Integration

  1. In Settings → Integration, scroll to User Integrations and click Connect on QuickBooks.
  2. Click Start connection, then sign in to Intuit, choose the company, and approve access in the window that opens.
  3. When the window closes, QuickBooks shows as connected under User Integrations. Only your own agents and chats use it.

Edit Integration

Editing is not supported. A connection belongs to the company you chose when you authorized it, so to connect a different company, disconnect QuickBooks and connect it again, choosing the other company. If the connection stops working — for example, because the authorizing user lost access to the company — open the card’s ⋯ menu, choose Details, and click Reconnect.

Delete Integration

Open the QuickBooks card’s ⋯ menu and choose Disconnect. This removes the connection and its stored credential from Fours, and agents lose their QuickBooks tools straight away. Disconnecting an org-level connection is admin-only.

See which company is connected

Open the QuickBooks card’s ⋯ menu and choose Details. Under Company, Fours reads the connected company from QuickBooks and shows its Name, Legal name, Country, Email, Fiscal year starts and Company ID. If the panel can’t load the company, reconnect from the same panel.

Fours AI Tools

When QuickBooks is connected, the Fours AI agent gets 16 QuickBooks tools. Each one works on the connected company only. Which of them a given agent receives depends on the access you give it for QuickBooks — Read-only, Edit or Full — see Agent access levels.

Org-level and user-level: The same 16 tools at both levels.

Look things up (Read-only)

ToolDescription
get-accountGet the connected QuickBooks company: its name, legal name, country, contact email, fiscal year start and company ID.
queryRun one read-only QuickBooks query (a SELECT over a single entity, such as Customer, Invoice, Item, Account, Vendor, Bill or Payment) and return the matching rows, up to 1,000 per page.
get-entityRead one QuickBooks record by entity type and ID — an invoice, customer, item, bill, payment, account, vendor and more.
get-reportRun a QuickBooks report for a period — profit and loss, balance sheet, cash flow, trial balance, general ledger, aged receivables and payables, customer and vendor balances, sales by customer or item, and the transaction list.
list-customersList customers by display name, optionally searching by name, with each one’s open balance.
list-invoicesList invoices, newest first, optionally for one customer, only unpaid ones, or within a date range.

Create and change records (Edit)

ToolDescription
create-customerCreate a customer.
update-customerUpdate a customer, changing only the fields given, or reactivate an inactive one.
create-invoiceCreate an invoice for a customer, one line per product or service.
update-invoiceUpdate an invoice, changing only the fields given. Lines, when given, replace all of the invoice’s lines.
send-invoiceEmail an invoice to the customer from QuickBooks, optionally to a different address.
create-paymentRecord a customer payment, optionally applied to their invoices. Whatever isn’t applied stays as a credit.
create-itemCreate a product or service (item) that invoices can sell.

Remove records (Full)

ToolDescription
deactivate-customerMake a customer inactive — QuickBooks’ delete for customers: hidden from lists and forms, with its history kept. update-customer reactivates it.
void-invoiceVoid an invoice: it stays on record, but every amount becomes zero. This cannot be undone.
delete-invoicePermanently delete an invoice. To keep a record of it, void it instead.

The create tools accept a request ID, so a create that is sent again unchanged, with the same request ID, after a timeout returns the record it already made instead of a duplicate.

Spotted something wrong or out of date on this page? Tell us and we'll correct it.