Connecting QuickBooks
Connect your QuickBooks Online account to EquineOps to enable automatic data synchronization. This guide walks you through the complete connection process from start to finish.
Before You Begin
Complete these prerequisites before starting the connection process to ensure a smooth setup.
✅ Prerequisites Checklist
Verify QuickBooks Online Subscription
Confirm you have:
- Active QuickBooks Online account (not QuickBooks Desktop)
- Admin or Master Admin user access
- Company file you want to connect is accessible
QuickBooks Desktop Not Supported: This integration only works with QuickBooks Online. If you use QuickBooks Desktop, you’ll need to migrate to QuickBooks Online first or use manual expense entry.
Confirm EquineOps Plan
Verify your EquineOps subscription:
- Professional or Enterprise plan
- Organization admin access in EquineOps
- Integration features enabled
Check Your Plan:
- Go to Settings → Billing
- Confirm plan level includes “QuickBooks Integration”
- Contact support if you need to upgrade
Prepare QuickBooks Data
Get your QuickBooks ready for connection:
Chart of Accounts:
- Review expense categories
- Remove or mark inactive unused categories
- Ensure categories are properly named
Vendors:
- Add frequently used vendors
- Clean up duplicate vendor entries
- Make inactive any vendors no longer used
Customers (if syncing to Clients):
- Verify customer records are current
- Clean up duplicate customers
- Update contact information
Tip: A clean QuickBooks setup before connecting means less cleanup after the initial sync.
Have QuickBooks Login Ready
You’ll need your QuickBooks credentials:
- Email address for QuickBooks account
- Password
- Two-factor authentication device (if enabled)
Connection Process
Follow these steps to connect QuickBooks to EquineOps.
Navigate to Integrations
- Log in to EquineOps
- Click Settings (gear icon) in the navigation
- Select Integrations from the settings menu
- Find QuickBooks Online in the list
- Click “Connect to QuickBooks” button
Start OAuth Authorization
You’ll be redirected to the QuickBooks authorization page.
What You’ll See:
- QuickBooks login screen (if not already logged in)
- Company selection (if you have multiple companies)
- Permission authorization screen
OAuth 2.0: This is a secure industry-standard authorization process. EquineOps never sees or stores your QuickBooks password.
Log In to QuickBooks
If prompted, log in with your QuickBooks credentials:
- Enter your email address
- Enter your password
- Complete two-factor authentication if required
- Click “Sign In”
Already Logged In? You’ll skip directly to company selection.
Select Your Company
If you have multiple QuickBooks companies:
- Review the list of available companies
- Select the company you want to connect to EquineOps
- Click “Continue”
Choose Carefully: You can only connect one QuickBooks company to each EquineOps organization. Select the correct company file.
Review Permissions
QuickBooks shows you what permissions EquineOps is requesting:
Read Access (EquineOps can view):
- Chart of Accounts
- Vendor list
- Customer list
Write Access (EquineOps can create):
- Expense/Purchase records
- Attach receipt images
EquineOps Cannot:
- Modify or delete existing transactions
- Access bank accounts
- View financial statements
- Modify chart of accounts
- Access payroll data
These permissions allow EquineOps to sync categories, vendors, customers, and push expenses to QuickBooks while keeping your other financial data private.
Authorize the Connection
- Review the requested permissions
- Check “I authorize Intuit to share my data with EquineOps” (if required)
- Click “Authorize” or “Connect”
You’ll be redirected back to EquineOps.
Wait for Initial Sync
After authorization, EquineOps performs an initial sync:
What’s Syncing:
- All expense categories from your QuickBooks Chart of Accounts
- All active vendors
- All active customers (synced to Clients in EquineOps)
How Long: Typically 1-2 minutes depending on data volume
Progress Indicator: You’ll see a loading screen showing sync progress
Don’t Close the Page: Let the initial sync complete. Closing the page won’t cancel it, but you won’t see the completion confirmation.
Review Sync Results
After initial sync completes, review the results:
Sync Summary Shows:
- Number of categories imported
- Number of vendors imported
- Number of customers imported
- Any sync warnings or errors
What to Check:
- Category names look correct
- Key vendors are present
- Customer data synced properly
Configure Sync Settings (Optional)
Customize your sync preferences:
Sync Schedule:
- Automatic (recommended): Syncs on schedule (categories/vendors 3x daily, expenses hourly)
- Manual: You control when data syncs
Customer Sync:
- Enabled: QuickBooks customers sync to EquineOps Clients
- Disabled: Manage clients independently
Expense Sync Direction:
- Enabled by default (EquineOps → QuickBooks)
- Cannot be disabled while connected
Default Settings: Work well for most organizations. Change only if you have specific needs.
Test the Connection
Verify the connection is working:
- Check Categories: Go to Expenses → Categories - should see QuickBooks categories
- Check Vendors: Go to Expenses → Vendors - should see QuickBooks vendors
- Check Clients (if enabled): Go to Clients - should see QuickBooks customers
- Record Test Expense: Create a simple expense and verify it syncs within an hour
Test Expense: Create an expense for a few dollars with a clear description like “Test - QuickBooks Integration”. Check QuickBooks after an hour to confirm it appeared.
Post-Connection Setup
After connecting, complete these additional setup tasks.
Review and Organize Categories
Check the categories synced from QuickBooks:
- Go to Settings → Expense Categories
- Review all synced categories
- Note any categories marked as “From QuickBooks” (read-only)
Categories Marked Read-Only:
- Cannot be edited in EquineOps
- Changes must be made in QuickBooks
- Will sync updates automatically
You Can Still:
- Add EquineOps-only categories if needed
- Archive unused categories
- Use any category for expenses
Review Vendors
Check vendors synced from QuickBooks:
- Go to Settings → Vendors
- Review vendor list
- Note vendors marked “From QuickBooks” (read-only)
If Vendors Are Missing:
- Add them in QuickBooks
- Wait for next automatic sync (or trigger manual sync)
- They’ll appear in EquineOps within hours
Review Clients (If Syncing Customers)
If customer sync is enabled:
- Go to Clients
- Review clients synced from QuickBooks
- Verify contact information
- Note clients marked “From QuickBooks” (read-only)
Mixed Client Management:
- QuickBooks customers appear as read-only clients
- You can add EquineOps-only clients
- Both types work together seamlessly
Set Up Staff Permissions
Configure who can manage expenses and see integration settings:
- Go to Settings → Staff
- For each staff member, set permissions:
- Manage Expenses: Can record expenses that sync to QuickBooks
- View Integration Settings: Can see sync status
- Manage Integrations: Can connect/disconnect (admin only)
Best Practice: Most staff need only “Manage Expenses” permission.
Train Your Team
Prepare your team to use the integrated system:
Key Points to Cover:
- How to record expenses in EquineOps
- Categories and vendors are from QuickBooks (read-only)
- Expenses sync automatically (hourly)
- How to attach receipt photos
- When to use manual sync
Training Resources:
- Recording Expenses Guide
- Expense Categories Guide
- In-app tooltips and help
Connection During Onboarding
You can also connect QuickBooks during the EquineOps onboarding process.
Onboarding Connection Flow
When setting up a new EquineOps organization:
- Choose Integrations Step: Select “Connect QuickBooks”
- Follow OAuth Flow: Same authorization process as above
- Initial Sync: Completes during onboarding
- Continue Setup: Proceed with rest of onboarding
Benefits:
- Categories and vendors available immediately
- No need to create categories manually
- Customers sync to seed your client list
Can Skip: If not ready to connect during onboarding, you can connect later from Settings → Integrations.
Connecting Later
Didn’t connect during onboarding? No problem:
- Complete EquineOps setup without QuickBooks
- Add initial horses, staff, and basic data
- Connect QuickBooks when ready
- Existing EquineOps data remains intact
- QuickBooks data merges with existing data
Existing Categories/Vendors: EquineOps attempts to match existing items with QuickBooks items during initial sync.
Verifying the Connection
Confirm everything is working correctly.
Check Connection Status
- Go to Settings → Integrations → QuickBooks
- Verify status shows “Connected”
- Check last sync times for each data type:
- Categories: Should show recent sync
- Vendors: Should show recent sync
- Customers: Should show recent sync (if enabled)
- Expenses: Will sync after first expense recorded
Verify Data Sync
Categories:
- Count categories in QuickBooks (expense accounts only)
- Count categories in EquineOps from QuickBooks
- Numbers should match (approximately)
Vendors:
- Look for a specific vendor in QuickBooks
- Search for same vendor in EquineOps
- Should find it marked “From QuickBooks”
Customers (if syncing):
- Pick a customer in QuickBooks
- Search clients in EquineOps
- Should appear as a client marked “From QuickBooks”
Test Expense Sync
Record a test expense to verify sync:
Record Test Expense in EquineOps
- Go to Expenses → Add Expense
- Enter test details:
- Date: Today
- Amount: $1.00
- Category: Select a QuickBooks category
- Vendor: Select a QuickBooks vendor
- Description: “Test - QB Integration”
- Save expense
Wait for Sync
Expenses sync hourly during business hours (6am-10pm in your timezone).
Options:
- Wait up to 1 hour for automatic sync
- Or use manual sync (Settings → Integrations → QuickBooks → Sync Now)
Check QuickBooks
After sync time:
- Log in to QuickBooks
- Go to Expenses or Purchases
- Look for your test expense
- Verify details match (amount, category, vendor, description)
Mark Test Complete
Found your test expense in QuickBooks? Connection is working!
In QuickBooks: You can delete the test expense if desired.
Troubleshooting Connection Issues
Connection Failed
Error: “Unable to connect to QuickBooks”
Possible Causes:
- Incorrect QuickBooks credentials
- Not an admin user
- Network or browser issues
- Pop-up blocker preventing authorization
Solutions:
- Verify you’re using the correct QuickBooks account
- Confirm you have admin access in QuickBooks
- Try a different browser
- Disable pop-up blockers temporarily
- Check internet connection
Authorization Denied
Error: “Authorization was denied”
Cause: You clicked “Cancel” or “Deny” on the QuickBooks authorization screen.
Solution:
- Return to EquineOps Settings → Integrations
- Click “Connect to QuickBooks” again
- Complete authorization and click “Authorize”
Company Already Connected
Error: “This QuickBooks company is already connected to another EquineOps organization”
Cause: The QuickBooks company file is already connected to a different EquineOps organization.
Solution:
- Disconnect from the other EquineOps organization first
- Or connect a different QuickBooks company to this organization
- Contact support if you need help identifying the other connection
Initial Sync Incomplete
Problem: Initial sync appears stuck or incomplete.
Solutions:
- Refresh the page - sync may have completed
- Check Settings → Integrations for sync status
- Try manual sync: Click “Sync Now”
- Wait 5 minutes and check again
- Contact support if still stuck after 15 minutes
No Categories or Vendors Synced
Problem: Sync completed but no categories or vendors appear.
Possible Causes:
- QuickBooks has no expense accounts set up
- All vendors are inactive in QuickBooks
- Sync filtered items due to account type
Solutions:
- Check QuickBooks Chart of Accounts has expense accounts
- Verify vendors are active in QuickBooks
- Trigger manual sync
- Contact support with sync log details
Security Best Practices
Protect QuickBooks Access
Use Strong Passwords: QuickBooks account should have strong, unique password
Enable Two-Factor Authentication: Add extra security layer to QuickBooks login
Limit Admin Users: Only give QuickBooks admin access to those who need it
Review Regularly: Periodically review who has QuickBooks access
Monitor Connection
Check Sync Status: Review sync logs weekly for any errors
Verify Sync Times: Ensure data is syncing on schedule
Review Permissions: Periodically confirm EquineOps still has needed permissions
Audit Expenses: Spot-check that expenses in EquineOps match QuickBooks
Disconnecting Safely
If you need to disconnect QuickBooks:
- Go to Settings → Integrations → QuickBooks
- Click “Disconnect”
- Confirm disconnection
What Happens:
- No new data will sync
- Existing data in both systems remains unchanged
- Categories/vendors become editable in EquineOps
- You can reconnect anytime
Before Disconnecting: Ensure all expenses have synced to QuickBooks. Check last sync time and review any pending expenses.
Next Steps
Successfully connected? Here’s what to do next:
- Understand Data Sync - Learn how sync works and when it runs
- Start Recording Expenses - Begin using the integrated workflow
- Review Troubleshooting - Familiarize yourself with common issues
- Train Your Team - Ensure staff knows how to use the integration
Need Help?
Questions about connecting QuickBooks?
- Email: support@equineops.com
- Pre-Connection Consultation: Contact support before connecting if you have complex QuickBooks setup
We’re here to help ensure a smooth connection process!
Related Topics
- QuickBooks Integration Overview - Integration features and benefits
- Data Sync Details - How sync works
- Troubleshooting - Common problems and solutions
- Managing Expenses - Recording expenses in EquineOps