PlansBuildersFor ContractorsFor HomeownersFor BuildersPricingHelpStart Free Trial

Accounting Integrations

Sync invoices, customers, and items with QuickBooks, Xero, FreshBooks, or Wave

On this page

OverviewSupported IntegrationsConnecting Your Accounting SoftwareCustomer Import After ConnectionItem ImportWhat Syncs AutomaticallyMonitoring Sync HealthDisconnectingTipsQuestions

Overview

BlueClerk integrates with QuickBooks, Xero, FreshBooks, and Wave to keep your books in sync automatically. Connect your accounting software once, then invoices, customers, and items sync automatically - no double entry required. BlueClerk monitors sync health and alerts you with a red badge on the Finance sidebar when sync failures occur.

NEW: Safe sync protections prevent duplicate invoices and unmapped items from corrupting your books. Duplicate syncs are debounced automatically, and items without income accounts are skipped with clear error messages.

NEW: Customer Import with Smart Classification & Address Deduplication - After connecting QuickBooks or Xero, import all your customers at once with AI suggestions for customer type. BlueClerk automatically classifies customers as Homeowner, Builder, or Business based on company names, email domains, and 60+ business keywords like gym, fitness, church, school, hotel, apartment, clinic, dental, auto, storage, farm, etc.

When importing homeowners with addresses, BlueClerk prevents duplicate properties:

  1. Matches against existing properties by street address first (free)
  2. If no match, geocodes via Google Maps to get a placeId (one API call)
  3. Checks by placeId to catch the same address stored differently
  4. If still no match, creates a new property with placeId saved
  5. The placeId is stored so the address never gets pinged again

Google only gets called for genuinely new addresses. Existing properties with placeId are matched for free.

NEW: Item Import - Import service items and products from your accounting software with one click. See QuickBooks item types, costs, and taxable status, then bulk-import with type classification (SERVICE/PRODUCT).

Supported Integrations

  • QuickBooks Online
  • Xero
  • FreshBooks
  • Wave

Connecting Your Accounting Software

QuickBooks Online

  1. Go to Settings > Integrations
  2. Click "Connect QuickBooks"
  3. Sign in to QuickBooks when prompted
  4. Authorize BlueClerk to access your company data
  5. You're connected - Customer and item import wizard launches automatically

Xero

  1. Go to Settings > Integrations
  2. Click "Connect Xero"
  3. Sign in to Xero when prompted
  4. Select your organization
  5. Authorize BlueClerk
  6. You're connected - Customer and item import wizard launches automatically

FreshBooks

  1. Go to Settings > Integrations
  2. Click "Connect FreshBooks"
  3. Sign in to FreshBooks
  4. Authorize BlueClerk
  5. You're connected

Wave

  1. Go to Settings > Integrations
  2. Click "Connect Wave"
  3. Follow the authorization flow
  4. You're connected

Customer Import After Connection

After connecting QuickBooks or Xero, BlueClerk automatically opens a wizard to import your customers:

Step 1: AI Classification

  1. Review the customer list fetched from your accounting software
  2. See AI suggestions for each customer type:
    • Homeowner - Individual names and residential addresses
    • Business - Commercial keywords (gym, hotel, clinic, apartment, etc.) or company email domains
    • Builder - Construction-related company names
  3. Adjust any incorrect suggestions with the dropdown
  4. New customers are auto-selected for import; existing matches show but are skipped

Step 2: Address Deduplication for Homeowners

When importing homeowners with addresses:

  1. BlueClerk matches by street address first - Finds existing properties instantly
  2. If no match, geocodes via Google Maps - Gets placeId for the address
  3. Checks by placeId - Catches same address stored differently ("123 Main St" vs "123 Main Street")
  4. If still no match, creates new property - Saves placeId for future matching
  5. placeId is permanent - Address never gets pinged again after first geocode

This prevents duplicate properties while minimizing Google Maps API costs.

Step 3: Confirm Import

  1. Review the summary of customers to be imported
  2. Click "Import Customers"
  3. Wait for import to complete - Progress bar shows status
  4. See confirmation with count of imported customers

Item Import

Import service items and products from your accounting software:

From QuickBooks

  1. Go to Settings > Integrations
  2. Click your connected QuickBooks integration
  3. Click "Import Items" button
  4. Review the item list with QuickBooks item types, costs, and tax status
  5. Select items to import (new items auto-selected, existing matches shown)
  6. Classify each item as SERVICE or PRODUCT
  7. Click "Import Items"
  8. Items are added to your BlueClerk catalog with QuickBooks details

From Xero

Same process as QuickBooks - fetches items from Xero with type, price, and tax information.

What Syncs Automatically

Invoices

When you create or update an invoice in BlueClerk:

  • Invoice details sync to your accounting software
  • Line items are matched or created
  • Customer is matched or created
  • Payment status updates when paid

Payments

When customers pay online via Stripe or Square:

  • Payment is recorded in your accounting software
  • Invoice is marked paid
  • Payment method is noted

Customers

When you add customers in BlueClerk:

  • Customer details sync to your accounting software
  • Contact info is kept in sync
  • Updates flow both ways

Monitoring Sync Health

Sync Status Badge

BlueClerk monitors all accounting sync operations:

  • Red badge on Finance sidebar - Sync failures detected
  • Click Finance to see sync status on integrations page
  • Error messages show what failed and why

Common Sync Issues

Duplicate Invoice Error

  • BlueClerk prevents duplicate syncs automatically
  • If you see this error, the invoice already exists in your accounting software
  • Safe to ignore - no action needed

Unmapped Item Error

  • Line items must have income accounts in your accounting software
  • Add income accounts in QuickBooks/Xero/FreshBooks/Wave
  • Re-sync the invoice after fixing

Token Expired

  • Occasionally accounting software tokens expire
  • BlueClerk auto-refreshes tokens when possible
  • If you see "Token expired", reconnect your integration

Disconnecting

To disconnect an integration:

  1. Go to Settings > Integrations
  2. Find your connected integration
  3. Click "Disconnect"
  4. Confirm disconnection
  5. Syncing stops - existing data remains in both systems

Tips

  • Connect early - Set up your integration before creating invoices to avoid manual data entry
  • Import customers first - Use the post-connection wizard to bring in existing customers
  • Import items too - Bring in your service catalog from your accounting software
  • Monitor sync health - Check the Finance sidebar for red badges indicating sync issues
  • Fix unmapped items - Add income accounts in your accounting software before syncing invoices
  • Let deduplication work - Address matching and geocoding happen automatically during customer import

Questions

Q: Do I have to use an accounting integration? A: No - BlueClerk works standalone. Integrations are optional for businesses that want automatic bookkeeping.

Q: Can I sync invoices I created before connecting? A: Yes - existing invoices will sync when you connect your accounting software.

Q: What if a customer exists in both systems? A: BlueClerk matches by email first, then by name. Duplicates won't be created.

Q: Will connecting affect my existing accounting data? A: No - BlueClerk only adds new records. Existing data in your accounting software is never modified.

**Q: How

Was this helpful?
Contact Support →

Invoicing & Payments