Setting up QuickBooks
Authenticate
Log in with your QuickBooks Online credentials and authorize the connection. Select the QuickBooks company file to connect.
What syncs
| Data type | Direction | Details |
|---|---|---|
| Invoices | HoopAI to QuickBooks | Invoices created in Hoop are pushed to QuickBooks as invoices |
| Payments | HoopAI to QuickBooks | Payments received in Hoop are recorded against the corresponding QuickBooks invoice |
| Contacts | HoopAI to QuickBooks | Contacts are synced as customers in QuickBooks when an invoice is created |
| Products | Manual mapping | Map HoopAI products to QuickBooks items for accurate line-item reporting |
Automatic sync vs. manual sync
- Automatic sync — once connected, new invoices and payments sync automatically within minutes of being created or received
- Manual sync — use the Sync Now button in the integration panel to force an immediate sync of pending records
Only invoices created after the integration is connected will sync automatically. Historical invoices must be reconciled manually in QuickBooks.
Mapping fields
After connecting, map your HoopAI data fields to QuickBooks fields:- Go to Settings > Integrations > QuickBooks > Field Mapping
- Map each HoopAI product to the corresponding QuickBooks item
- Map tax settings to match your QuickBooks tax codes
- Save the mapping configuration
Troubleshooting sync errors
Invoice failed to sync
Invoice failed to sync
Check that the contact exists as a customer in QuickBooks. If the contact name contains special characters, QuickBooks may reject it. Also verify that all required QuickBooks fields (customer name, line items) are populated.
Duplicate records in QuickBooks
Duplicate records in QuickBooks
Duplicates occur when the same contact is created both manually in QuickBooks and via sync. Use the QuickBooks merge feature to consolidate duplicates, then verify field mapping is correct.
Connection expired
Connection expired
QuickBooks tokens expire after a period of inactivity. Reconnect by going to Settings > Integrations > QuickBooks and clicking Reconnect.
Limitations
- Only QuickBooks Online is supported — QuickBooks Desktop is not compatible
- Sync is one-directional for invoices and payments (HoopAI to QuickBooks)
- Refunds must be recorded manually in QuickBooks
- Multi-currency support depends on your QuickBooks plan