How to Set Up QuickBooks on Luminous

If you use QuickBooks to manage accounting and Luminous to manage operations, connecting the two is a no-brainer. But here's the truth: our QuickBooks integration was built outside the usual flow, so the setup isn't as intuitive as other Luminous integrations (yet).

‍

That said—it works. And once it's live, it keeps your financials and ops fully aligned.

‍

Below is a straightforward guide to setting it up in just a few minutes.

‍

What This Integration Does

‍

Connecting QuickBooks to Luminous allows you to:

• Automatically sync invoices and purchase orders
• Eliminate manual data entry and reduce reconciliation errors
• Keep your financials up to date in real-time

It's one of the fastest ways to clean up your backend and keep your books accurate without creating more busy work.

‍

Before You Start: Checklist

• Admin access to Luminous, so you can open System Settings and Manage Channels.
• Your QuickBooks login, and permission to connect apps to the QuickBooks company you want to link.
• The name of the QuickBooks company you'll connect, if you have more than one.
• The asset, expense, income and AP accounts you plan to use, ideally confirmed with your accountant.

‍

Step-by-Step Setup Guide

‍

1. Go to System Settings

‍

In Luminous, head to your System Settings page.

‍

2. Enable QuickBooks Sync

‍

On the right-hand side, locate the QuickBooks Settings section.
Toggle on the QuickBooks Sync switch to enable the connection.

‍

3. Add a New Channel

‍

Now go to the Manage Channels section and do the following:

‍

• Click Add Channel
  
  
• Name the channel something like QuickBooks
  
  
• Leave all the other configuration fields empty
  
  
• Click Save
  

⚠️ Yes, you’re saving a blank channel on purpose. It’s a required step for the integration handshake.

‍

4. Authenticate with QuickBooks

‍

Once the channel is saved:

‍

• Click the ellipsis (three dots) next to your new QuickBooks channel
  
  
• Select Renew QuickBooks Tokens
  

This will open a login modal. If you're already signed into QuickBooks, it will take you directly to your list of companies.

‍

5. Choose Your Company and Authorize

‍

• Select the appropriate company from your QuickBooks account
  
  
• Click Next to complete the connection

You're now connected.

What Happens After Setup

‍

Once connected, Luminous will:

• Push invoices to QuickBooks, and purchase orders too once Purchase Order Sync is turned on
  
  
• Map order data directly to the correct accounts
  
  
• Keep your inventory and COGS aligned with accounting

Everything flows automatically in the background—no more CSVs, no more double entries.

‍

Pro Tips

• Set it and forget it: Once linked, the sync runs in the background. If the connection ever lapses, use Renew QuickBooks Tokens on the channel to reconnect.
  
  
• Use naming conventions: Keep the QuickBooks channel name clean for easier reporting.
  
  
• Double-check account mappings: Make sure the asset, expense, income and AP accounts in QuickBooks Settings match the accounts you use in QuickBooks.

Troubleshooting the Connection

• Nothing is syncing: confirm that QuickBooks Sync is still toggled on in System Settings > QuickBooks Settings.
• The wrong company is connected: use Renew QuickBooks Tokens on the QuickBooks channel and choose the correct company when the QuickBooks modal opens.
• The connection stopped working: tokens can lapse, for example after a password change. Renew QuickBooks Tokens to reconnect.
• Invoices sync but POs don't: purchase orders need their own toggle. Turn on QuickBooks Purchase Order Sync in QuickBooks Settings.
• Transactions land in the wrong accounts: review the asset, expense, income and AP mappings in QuickBooks Settings with your accountant.

What’s Next

‍

This integration is likely to change in the future to align with our standard integrations flow. That could mean:

• Faster setup
  
  
• More customization
  
  
• Tighter sync logic

Until then, this guide gives you everything you need to go live today.

Common Questions

Why do I save a blank channel? The QuickBooks connection is attached to a channel. Saving the channel first gives you the three-dot menu where you can choose Renew QuickBooks Tokens and link your QuickBooks company.

Do I have to log in to QuickBooks every time? No. If you're already signed in to QuickBooks, the modal takes you straight to your list of companies. You only need to renew tokens if the connection lapses.

Is there anything else to set up? Yes. Check your account mappings in QuickBooks Settings, and turn on Purchase Order Sync if you want POs pushed too. See How to Connect Your QuickBooks Account to Luminous and How to Enable Purchase Order Sync to QuickBooks in Luminous.

Need Help?

‍

Want your ops and accounting to finally talk to each other? Luminous + QuickBooks = clarity, speed, and zero manual effort. If you’d rather have our team walk you through it, we’re happy to help. Book a demo today.