Skip to main content

Connect your accounting system

Updated yesterday

Acctual integrates seamlessly with QuickBooks Online and Xero, automatically syncing your invoices, contacts, and payment data to keep your books up to date — whether you're invoicing in fiat or crypto.


Why connect your accounting system?

Automatic invoice sync

Every invoice you create in Acctual is automatically synced to your accounting system, including all the data needed for journal entries. Works for both fiat and crypto invoices.

Automatic contact sync

All your existing customers from QuickBooks or Xero are pulled into Acctual. When creating an invoice, you can select from customers that already exist in your accounting system — no need to re-enter information.

Save time on bookkeeping

No more manual data entry or reconciliation. Acctual populates all the necessary information for your journal entries automatically.

Support for crypto invoicing

Even if you're invoicing in crypto, Acctual handles the accounting entries correctly in your traditional accounting system.

Supported accounting systems

System

What syncs

QuickBooks Online

Invoices, Customers, Payments

Xero

Invoices, Customers, Payments


How to connect your accounting system

Step 1: Navigate to settings

  1. Log into your Acctual account

  2. Click Settings in the sidebar

  3. Select the Accounting tab

Step 2: Choose your accounting system

You'll see two options:

  • QuickBooks (QuickBooks Online)

  • Xero

Click on the accounting system you use.

Step 3: Sign into your accounting system

After selecting your accounting system, you'll be redirected to sign in:

For QuickBooks:

  • You'll see the Intuit login screen

  • Sign in with your QuickBooks Online account credentials

  • If you have multiple accounts, select the one you want to connect

  • Authorize Acctual to access your QuickBooks data

For Xero:

  • You'll see the Xero login screen

  • Sign in with your Xero account credentials

  • Select the organization you want to connect

  • Authorize Acctual to access your Xero data

Step 4: Automatic connection

Once you've signed in and authorized the connection, Acctual will automatically:

  • Link to your accounting system

  • Pull all your existing customers

  • Begin syncing new invoices and payments

You'll be redirected back to Acctual, and the connection will be active immediately.


What gets synced?

Invoices

When you create an invoice in Acctual, it automatically syncs to your accounting system with:

  • Customer information

  • Invoice number

  • Line items and amounts

  • Invoice date and due date

  • Payment terms

  • All necessary data for journal entries

This works for both:

  • Fiat invoices (USD, EUR, etc.)

  • Crypto invoices (USDT, USDC, ETH, etc.)

Acctual handles the accounting entries correctly regardless of currency type.


Contacts

When you first connect, Acctual pulls all your existing customers from your accounting system.

When you create an invoice, you can:

  • Select from customers that already exist in QuickBooks or Xero

  • Avoid re-entering customer information

  • Keep customer data consistent across both systems

When you create a new contact in Acctual, it also syncs to your accounting system.


Payments

When your clients pay invoices through Acctual, payment information is automatically recorded in your accounting system, including:

  • Payment amount

  • Payment date

  • Payment method

  • Matching to the correct invoice


Troubleshooting

Connection failed

If you're having trouble connecting your accounting system:

  1. Check your credentials – Make sure you're using the correct login for QuickBooks or Xero

  2. Verify permissions – Ensure your user account has admin access to the accounting system

  3. Try again – Sometimes connection issues are temporary; wait a moment and retry

If the issue persists, contact support@acctual.com or file a ticket through in app messenger.

Invoices not syncing

If invoices aren't appearing in your accounting system:

  1. Check connection status – Go to Settings → Accounting and verify the connection is active

  2. Verify invoice is finalized – Only finalized/sent invoices sync (drafts do not sync)

  3. Wait a moment – Syncing can take 1-2 minutes

  4. If the invoice uses a different currency than your base or customer’s assigned currency, it may fail to sync. Make sure multicurrency is enabled and customer currency settings match. From there retry steps 1-3.

If invoices still aren't syncing after 5 minutes, contact support.

Troubleshooting multicurrency sync issues

If you’re syncing invoices that use multiple currencies, ensure multicurrency support is enabled in your accounting system. By default, both QuickBooks Online and Xero only allow syncing in a single base currency unless this feature is turned on.

QuickBooks Online

Issue: Invoices in foreign currencies don’t appear in QuickBooks or fail to sync.

How to fix it:

  1. Go to Settings → Account and Settings → Advanced.

  2. Scroll to the Currency section.

  3. Toggle Multicurrency ON and confirm.

  4. Once enabled, select your home currency and add additional currencies as needed.

  5. Reconnect your QuickBooks account within Acctual to refresh the sync.

Important: Once multicurrency is turned on in QuickBooks, it cannot be turned off. Make sure this setting aligns with your accounting needs before enabling it.

Additional Tip: Each customer and account in QBO is assigned a currency. If an invoice is in a different currency than the customer’s default, you’ll need to edit the customer profile and update their assigned currency.


Xero

Issue: Invoices in multiple currencies are not syncing or showing incorrect currency codes.

How to fix it:

  1. Multicurrency support in Xero is available only on the Established or higher plan.

  2. To enable:

    • Go to Settings → Currencies.

    • Click Add Currency and select the currencies you want to use.

  3. Ensure that the contact and account in Xero are set to the same currency as your invoice in Acctual.

  4. Reconnect Xero within Acctual after enabling multicurrency to ensure data refresh.

Additional Tip: If you’ve upgraded your Xero plan to enable multicurrency, wait 5–10 minutes before reattempting sync to allow changes to propagate through the Xero’s system.


Contacts not appearing

If contacts from your accounting system aren't showing up in Acctual:

  1. Refresh the page – Sometimes a simple refresh resolves the issue

  2. Check connection – Verify your accounting system is still connected

  3. Re-sync – Disconnect and reconnect your accounting system to trigger a fresh sync


Need to disconnect?

To disconnect your accounting system:

  1. Go to Settings → Accounting

  2. Click Disconnect next to your connected system

  3. Confirm the disconnection

Note: Disconnecting will stop future syncing, but existing synced data will remain in both systems.


Frequently asked questions

Do I need a paid QuickBooks or Xero account?

Yes, you need an active subscription to QuickBooks Online or Xero to use the integration.

Can I connect both QuickBooks and Xero?

No, you can only connect one accounting system at a time.

What happens to invoices I created before connecting?

Only invoices created after connecting your accounting system will sync. Existing invoices will not be retroactively synced.

Can I sync crypto invoices to my accounting system?

Yes, Acctual handles crypto invoices correctly and populates the necessary accounting entries in your traditional accounting system.

What if I use QuickBooks Desktop?

Currently, Acctual only supports QuickBooks Online. QuickBooks Desktop is not supported at this time.

Do I need to enable multicurrency even if I only sometimes invoice in another currency?

Yes. Both QuickBooks and Xero require multicurrency to be turned on system-wide before syncing invoices in any non-base currency.

Can I turn multicurrency off after enabling it?

QuickBooks does not allow disabling multicurrency once turned on. Xero allows you to remove unused currencies but not fully disable the feature once activated.

How do I fix exchange rate discrepancies?

Both QBO and Xero use live exchange rates from their respective providers. You can manually override rates in your accounting system if needed to match Acctual’s invoice value.

My invoice synced but shows the wrong total — what should I do?

Check if the currency rounding or FX rate in QuickBooks/Xero differs from the rate applied in Acctual. Adjust the rate manually in your accounting platform to align with Acctual’s calculation.

What if I prefer to manage all my invoices in one currency?

You can continue using Acctual’s multicurrency invoicing features while syncing only invoices in your base currency. Just ensure your accounting settings reflect that preference.

Is my accounting data secure?

Yes. Acctual uses OAuth 2.0 for secure authentication and does not store your accounting system passwords. All data is encrypted in transit and at rest.


Next Steps

Once your accounting system is connected:

  1. Create an invoice – Learn how to create and send invoices


Need Help?

If you have questions about connecting your accounting system or troubleshooting sync issues:

Our team can help you get connected and ensure everything is syncing correctly.

Did this answer your question?