Need help installing your new integration from the marketplace? Check out this article!
Tribe's QuickBooks integration connects your CRM directly to one of the world's most widely used accounting platforms, allowing customer records and invoices to flow automatically between the two systems. If your business uses Tribe for sales and invoicing and QuickBooks for accounting, this integration removes the need for manual data entry across both platforms. It keeps customers, suppliers, and payment statuses in sync, so your records stay accurate and up to date without extra effort. By following this guide, you will be able to activate the integration, configure the required settings, and start synchronising your data between Tribe and QuickBooks.
Table of Contents
What functionalities does the integration with QuickBooks have?
Prerequisites
How to Activate the QuickBooks Integration
What Data Is Synchronised?
How Does Synchronisation Work?
Tips and Best Practices
Troubleshooting
What functionalities does the integration with QuickBooks have?
The QuickBooks integration consists of two components:
Relationship synchronisation
Invoice synchronisation
Relationship Synchronisation
When the integration is activated, during the initial synchronisation, customers and suppliers from QuickBooks are automatically loaded into Tribe CRM. A duplicates check is performed on the existing relationships in Tribe CRM. This check is based on a unique ID from QuickBooks. If this is not found, an additional check is performed based on the debtor or creditor number.
After the initial synchronisation, new relationships and changes in existing relationship data are automatically updated. This applies both from Tribe CRM to QuickBooks and vice versa. The synchronisation is based on the unique ID in QuickBooks.
A new customer or supplier always receives a debtor or creditor number in Tribe. If QuickBooks generates a debtor or creditor number, the number in Tribe is overwritten with the debtor or creditor number assigned by QuickBooks.
Invoice Synchronisation
When an invoice status is changed to "Sent", it will automatically synchronise as a booked invoice to QuickBooks. We ensure that you have all the necessary information complete by adding all relevant information to the booked invoice, such as date, invoice and product lines. Invoice PDFs from Tribe are also sent to QuickBooks as attachments.
Note: Invoice synchronisation can also be triggered manually by clicking the "Sync" button on the invoice. This button is available when "Send invoice from external system" is activated in the invoice menu.
Prerequisites
Before activating the integration, ensure the following are in place:
An active QuickBooks account with admin access to authorise the connection.
The Sales pack is activated in your Tribe instance.
VAT groups are configured in both Tribe and QuickBooks, ready to be mapped.
General Ledger (GL) accounts are assigned to products or VAT groups in Tribe.
All customer and supplier addresses include a street, postal code, city, and country.
How to Activate the QuickBooks Integration
Navigate to the Marketplace in Tribe.
Locate QuickBooks Accounting and click Install.
Follow the authentication prompt to connect via Chift. This uses a secure OAuth 2.0 flow — Chift manages the QuickBooks consent process on your behalf.
Once authenticated, map your VAT Groups between Tribe and QuickBooks using the mapping fields provided.
Confirm that General Ledger Accounts are assigned to your products or VAT groups. These are required for invoice export to function correctly.
Optionally, enable Supplier sync if you wish to import supplier records from QuickBooks into Tribe. This is disabled by default.
Click the Start Initial Sync button to begin the first full synchronisation of your customers, persons, and suppliers.
What Data Is Synchronised?
The table below outlines which data flows between Tribe and QuickBooks, and in which direction.
Tribe | QuickBooks | Tribe → QuickBooks | QuickBooks → Tribe |
Organisation (customer) | Client (Account) | Yes | Yes — every 10 min |
Person (customer) | Client (Account) | Yes | Yes — every 10 min |
Organisation (supplier) | Supplier | No | Yes — every 10 min |
Invoice + Lines | Sales Entry | Yes | No |
Invoice (payment status) | Payment | No | Yes — daily at 3:00 AM |
General Ledger Account | Chart of Accounts | No | Yes (income type only) |
VAT Group | VAT Rate | No | Yes |
Invoice (PDF attachment) | Base64 PDF | Yes | No |
How Does Synchronisation Work?
Synchronisation between Tribe and QuickBooks runs on different schedules depending on the type of data involved.
Initial sync runs once when you activate the integration and covers all existing customers, persons, and suppliers.
Customer and person records sync incrementally every 10 minutes, and near-instantly when a change is made in Tribe.
Invoices are exported to QuickBooks in near real-time whenever one is created or updated in Tribe.
Payment statuses are updated in Tribe once daily at 3:00 AM, based on payment data from QuickBooks.
Note: An invoice is considered paid when the total payments received are within €0.05 of the invoice amount. If a customer record has not yet been created in QuickBooks when an invoice is exported, the system will queue the record first and retry the invoice export after 120 seconds.
Tips and Best Practices
Map all VAT groups before exporting any invoices. Missing mappings will cause invoice sync failures.
Assign a General Ledger account to every product used in invoices. Where no product General Ledger account is set, the system falls back to the VAT group General Ledger account.
Ensure all addresses are complete — street, postal code, city, and country — to avoid sync errors on customer and supplier records.
Enable supplier sync only if you actively manage supplier records in QuickBooks and wish to see them reflected in Tribe.
Troubleshooting
Invoice export fails
Confirm that all VAT groups used in the invoice are mapped to a QuickBooks VAT rate, and that each product on the invoice has a General Ledger account assigned. Sync failure messages in Tribe include a description of the missing configuration.
Customer or supplier records are not appearing in QuickBooks
Check that the address fields are complete. Records with missing street, postal code, city, or country may not sync correctly.
Payment status is not updating in Tribe
Payment statuses sync once daily at 3:00 AM. If the status has not updated by the following day, verify that the invoice is not in draft status and that the total payments in QuickBooks are within €0.05 of the invoice total.
Connection issues after setup
If the OAuth connection to QuickBooks becomes invalid, return to the Marketplace, open the QuickBooks Accounting connector, and re-authenticate via Chift.
Quick Summary
The QuickBooks integration connects Tribe CRM to QuickBooks via Chift, synchronising customers, suppliers, invoices, and payment statuses between the two systems. Once activated and configured with the correct VAT group mappings and General Ledger accounts, data flows automatically with minimal manual input required. This integration is suitable for any business using both platforms and removes the need to manage records in two places separately.