Connect to QuickBooks
Linking Kinabase to your QuickBooks company
Connect Kinabase to QuickBooks Online to link records
Before You Start
You will need:
Only System Administrators can connect, disconnect, or switch the active accounting integration.
You'll sign in to Intuit during the OAuth flow. Kinabase requests access to the company (realm) you choose at sign-in.
The integration is built for QuickBooks Online. QuickBooks Desktop is not supported.
Connect QuickBooks
- Click your name in the bottom-left corner of Kinabase and select Settings.
- Navigate to Integrations → Accounting Integration.
- Find QuickBooks in the list of providers and click Connect.
- You will be redirected to Intuit to sign in and authorise Kinabase.
- Pick the QuickBooks company you want to connect (if you have access to more than one), review the requested permissions, and click Connect.
- Intuit redirects you back to Kinabase. A confirmation alert reads "Successfully connected to QuickBooks".
After connecting, Kinabase automatically pulls your Tax Codes and Chart of Accounts from QuickBooks.
Unlike Xero, QuickBooks is connected to a single company per integration. To switch companies, Disconnect and reconnect to the company you want.
Reference Data Synced From QuickBooks
When you connect QuickBooks, Kinabase populates two system collections:
Each QuickBooks tax code is imported with its name and status. Note that QuickBooks does not expose a single rate per code, so the rate field is left blank for QuickBooks-synced tax codes.
Each QuickBooks account is imported with its name, account number (if set), account type, and class (Asset, Liability, Equity, Revenue, Expense).
You can re-sync at any time from the three-dot menu on the QuickBooks row in Settings → Integrations → Accounting Integration by clicking Sync Reference Data.
When the integration is disconnected, the synced tax codes and ledger codes are archived but kept for historical records.
Customers and Suppliers in QuickBooks
QuickBooks stores Customers and Suppliers as separate entities, so a single QuickBooks contact cannot be both. Kinabase reflects this when you create or link contacts.
When you click Create new contact from a Kinabase record, you'll be asked:
QuickBooks stores customers and suppliers separately. Choose which type to create:
- Customer - Use for invoice and receivable contacts.
- Supplier - Use for bill and payable contacts.
This choice determines:
Customers are listed under Sales → Customers; Suppliers under Expenses → Suppliers.
Invoices can only be linked to Customers. Bills can only be linked to Suppliers. Kinabase will tell you if you try to use the wrong type:
"Invoices can only be sent to customers. The linked contact is a supplier - please link a customer contact instead."
When linking a collection configured as Invoices, the contact search is automatically filtered to Customers. For Bills, it filters to Suppliers.
Link Records to QuickBooks
Once QuickBooks is connected, the Accounting pane appears in each collection's configuration. Use it to choose what records
Each record can be linked to a QuickBooks customer or supplier. Outstanding receivables and payables appear in the record sidebar.
Each record can be linked to a QuickBooks item. Sales and purchase pricing appear in the sidebar. QuickBooks item types such as Category, Discount, Other Charge, Payment, Sales Tax, Subtotal, and Description Only are not linkable.
Records track invoices created from their line items, including coverage and payment status.
Records track bills created from their line items, including coverage and payment status.
For a full walkthrough, see our guide on configuring collections for accounting.
Use QuickBooks on a Record
Open any record in a collection that has QuickBooks linking enabled. A QuickBooks card appears in the sidebar with these controls:
- Link - search for an existing QuickBooks customer, supplier, item, invoice, or bill, or create a new one.
- Sync (refresh icon) - pull the latest data. A tooltip shows when it last synced.
- Open in QuickBooks (external link icon) - open the linked record in QuickBooks Online.
- Unlink - remove the connection. The QuickBooks record is untouched.
Creating an Invoice or Bill
On collections configured for Invoices or Bills, a Create Invoice (or Create Bill) button is available. The modal lets you:
- Tick the line items to include.
- Adjust quantities (where not driven by a mapped field).
- Override the tax code and ledger code for each line.
- See per-line totals and the overall total.
Click Create Invoice (or Create Bill) to push the transaction to QuickBooks.
QuickBooks does not have a Draft status equivalent to Xero. Invoices and bills created from Kinabase are posted to QuickBooks immediately. The Kinabase status reflects whether the transaction has been Sent, Paid, or simply Approved based on QuickBooks's state.
Disconnecting QuickBooks
- Go to Settings → Integrations → Accounting Integration.
- Open the three-dot menu on the QuickBooks row.
- Click Disconnect and confirm.
Kinabase stops syncing immediately. Records that were linked to QuickBooks customers, suppliers, items, invoices, or bills keep their last-known data for reference, but Sync and Create actions will no longer be available. Tax Codes and Ledger Codes are archived.
Connecting Xero while QuickBooks is connected will disconnect QuickBooks automatically. Kinabase will warn you with a Switch Accounting Provider dialog first.
QuickBooks-Specific Notes
Troubleshooting
Connecting your Kinabase to your accounting system helps streamline your day to day activities and align your operations and financial processes.
For more help contact your System Admin or our Support Team.
See also: Connect to Xero | Configuring collections for accounting.