Skip to main content
Connect Xero in one of two versions: Matching, review, and ownership stay in ClearSpend AI. ClearSpend AI does not replace Xero. Open Integrations and connect from the Xero card under Accounting.
ClearSpend AI → Xero is never automatic. Review charges first, then click Sync to Xero.
To switch to Xero, disconnect QuickBooks on Integrations first, then connect Xero.

Before you connect

Owners, Admins, and Contributors can connect. See Roles and permissions.

Connect Xero

1

Open Integrations

In the sidebar, go to Integrations.
2

Open the Xero card

Under Accounting, find the Xero card and click Connect.
3

Sign in and pick your organization

Sign in with your Xero account, allow ClearSpend AI access, and choose the organization you want to sync with. You can add more organizations later.
4

Finish sync setup

Choose the Xero account, a ClearSpend AI bucket, and the version (Xero → ClearSpend AI or ClearSpend AI → Xero). One bank account maps to one bucket.
5

Choose a schedule

Pick how often Xero → ClearSpend AI imports charges. You can change this later from Integrations. Pushing with ClearSpend AI → Xero stays manual.
When setup is done, the Xero card on Integrations shows as connected. If you chose Xero → ClearSpend AI, imported charges appear on Transactions.
It worked when: the Xero card on Integrations shows as connected with a last sync time. Open Transactions — charges from your Xero bank account should be listed there.

Buckets

A bucket is a group of transactions in ClearSpend AI. Use one bucket per bank or card account so imported and pushed charges stay separate. Each Xero bank account can be linked to one bucket. Another Xero connection cannot reuse that account or that bucket. If either is already in use, it is greyed out. Every workspace starts with All Transactions. Create more from Manage buckets in the bucket picker. See Managing buckets.
Transaction Buckets drawer with Create a bucket, All Transactions default, and a Chase bucket

Transaction Buckets: create a bucket, see which accounts are linked, and rename or delete.

Pull from Xero

With Xero → ClearSpend AI, ClearSpend AI pulls posted activity from the bank or card account you selected during setup. Those charges appear on Transactions and count toward Home totals. Pair this with Gmail, Google Drive, or a file upload so each charge can be matched to proof.

What gets pulled

Debit and credit

Every pulled Xero transaction is classified as either debit or credit: Anything paid out is a debit. Everything else is a credit. Subscriptions are created only from debit transactions. Credits stay on Transactions but do not create subscriptions.

What is not pulled

ClearSpend AI only pulls activity tied to the connected bank or card account. It does not pull items that are not posted to that account yet.

Push to Xero

ClearSpend AI → Xero sends reconciled charges from ClearSpend AI to Xero. It runs only when you click Sync to Xero. Key rules:
  • You can only push debit transactions. Credits are not sent.
  • Pushed charges become SPEND bank transactions on the same Xero bank or card account you chose during setup.
  • Each charge needs a GL code and a matched invoice. Missing either → stays in Needs Review.
  • The matched invoice or receipt file is attached to the new Xero record.

How to push

1

Have debit transactions ready

Start with debit charges already in ClearSpend AI from Xero → ClearSpend AI, Plaid, a statement upload, or earlier imports.
Transactions table with charges ready to reconcile

Transactions: charges in your workspace before you reconcile and assign GL codes.

2

Reconcile and add a GL code

Match an invoice or receipt to each charge, finish review, and assign a chart of accounts (GL) code. Charges missing either stay in Needs Review.
Transactions table after reconciling and adding GL codes

Transactions: reconciled charges with a GL code assigned.

3

Open Ready to Sync

On Transactions, open the Ready to Sync tab. Debit charges with both a matched invoice and a GL code appear here. Click Sync to Xero in the toolbar.
Ready to Sync tab with Sync to Xero button

Transactions: Ready to Sync tab with the Sync to Xero button.

4

Confirm on Synced

After the push finishes, open the Synced tab. Charges that synced successfully show here.
Synced tab showing charges pushed to Xero

Transactions: Synced tab after a successful push to Xero.

For sync status tabs and readiness rules, see Sync to accounting.

Duplicate matches on push

During a push (not during import), ClearSpend AI checks Xero for the same vendor, exact date, and amount. If it finds a match, the charge moves to Needs Review with an amber warning icon next to the date. To resolve:
  1. Open the Needs Review tab on Transactions.
  2. Find the row with the amber warning icon.
  3. Click ⋮ → Sync again.
  4. Choose one option:

Multiple organizations

You can connect more than one Xero organization. Each one appears on the Xero card on Integrations.

Disconnect

On Integrations, expand the Xero card and disconnect. Data already in ClearSpend AI stays.

Common questions

Yes, if you choose Xero → ClearSpend AI. Charges from the selected Xero account appear on Transactions. ClearSpend AI → Xero does not import spend.
Bills are not tied to a bank account until they are paid. ClearSpend AI pulls the Payment when money leaves the connected account.
The same bank or card account you chose when you configured the connection. Pushed SPEND transactions always post to that account.
No. Only debit transactions can be pushed. Credits stay in ClearSpend AI and are not sent to Xero.
No. Subscriptions are created only from debit transactions. Credits appear on Transactions with a Credit type label.
No. Push is manual. Review charges first, then click Sync to Xero.
During push, the charge moves to Needs Review. Open that tab, click ⋮ → Sync again, then choose Attach to existing or Create new anyway. This check does not run during import.
No. ClearSpend AI only sends charges when you sync them. It does not edit your books in the background.
A ClearSpend AI → Xero connection, a GL code on the charge, and a matched invoice. Without a GL code and matched invoice, the charge stays in Needs Review. See Sync to accounting.
On the charge row on Transactions, in the transaction detail panel, or from the subscription detail. A GL code is required before a charge can move to Ready to Sync.
No. One bank account can be linked to one bucket. Create another bucket if you need to connect a second account. See Managing buckets.