What Xero data does Well pull into Bill.com?

Xero streams bills, contacts, tracking categories, and tax types read over Xero's MCP server to Well over its MCP server. After Well resolves the counterparty and assigns a confidence score, the matched record posts to Bill.com as bills via email-in inbox, with vendor, invoice number, amount, and due date populated by Bill.com's IVA OCR, with the Xero event ID preserved on the entry for audit.

Will every Xero record post to Bill.com automatically?

Not always. Within seconds of Xero firing the event, Well scores the record on field completeness, counterparty strength, and policy fit. Above the 85% default auto-link threshold Well forwards the reconciled document to your Bill.com email-in address and Bill.com drafts the record from it for you to confirm. Between 55% and 85% the record waits in the review queue with the alternative matches ranked. Below the 55% default review threshold the record is refused and the candidate list kept so you can pin the right entry by hand.

How does Well match Xero records to entries in Bill.com?

Well scores every candidate match between Xero records and existing Bill.com entries on counterparty name, amount, date proximity, currency, and reference. Above 85% the record links to the historical entry and Bill.com updates; between 55% and 85% the candidates are queued for sign-off; below 55% the record stays open with the candidate list available.

What happens to historical Xero data when I first connect to Bill.com?

Xero exposes seven years of accounting history through its API on a connected account. The window Well actually pulls is configurable from the integration settings page; each record is matched against your existing Bill.com ledger, and re-running the backfill is safe because Well tracks the Xero record IDs and updates existing Bill.com entries instead of duplicating them.

Does Well handle multi-currency records between Xero and Bill.com?

Xero carries the original transaction currency on every record and Bill.com natively ledgers in multiple currencies. Well preserves the original amount, applies your Bill.com chart-of-accounts conversion rules at posting time, and both the source and converted amounts ride on the document Well forwards to Bill.com, so the Bill.com entry you post keeps both sides of the trade.

How does Well authenticate with Xero and Bill.com?

Xero's MCP server handles authorisation directly; Well receives an access token through Dynamic Client Registration and never sees raw user credentials. For the delivery side, Well forwards the reconciled document to your Bill.com email-in address once it clears the matching threshold; Bill.com creates the draft record from it and you confirm and post it. Well holds no write credential to Bill.com. Tokens are encrypted at rest and in transit under TLS 1.3. Xero and Bill.com together cover multiple regions; Well's storage region is configured per workspace.

Xero to Bill.com

AvailableNative · XeroNative · Bill.com

Connect Xero to Bill.com with Well

Move Xero bills and contacts through Well and into Bill.com as bills, with the audit trail kept on every record.

Connect both toolsView all integrations

Xero

Source

The Xero integration connects Well to your accounting platform for bidirectional data flow.

Bill.com

Target

The Bill.

Why this pair

Connect Xero to Bill.com through Well so records flow without manual rework.

What Well does between Xero and Bill.com

One-way: Xero into Well into Bill.com
Sync mode: Real-time MCP push
Events arrive in seconds

Trigger from Xero

5 events · pick one

Well engine·recipe·When a Xero invoice is read

Source

from upload · live webhook

AWS EMEA

via Xero

Invoice

When a Xero invoice is read

INV-2026-04-100 · 22 Apr 2026€1,284.00

Extract

6 fields read from Xero

6 fields read

VendorAWS EMEA
Invoice numberINV-2026-04-100
Issue date22 Apr 2026
Total€1,284.00
Tax€256.80

Enrich

against your historical record graph

5 fields added

Legal entityAWS EMEA
Tax idLU26888617
Domainamazon.com
Ledger account6156 · Cloud infra

Confidence97%

<55% refused55–85% review≥85% auto-posts

Post

schedule as bills

Create a bill in Bill.com inbox

auto-posted

posted

TypeBill
VendorAWS EMEA
Amount€1,284.00
Ledger6156 · Cloud infra
Source docattached
Confidence97%

audit linkto Bill.com

Action in Bill.com

2 compatible with this trigger

Create a bill in Bill.com inboxResolve a Bill.com vendor from the bill

12 signals and actions across Xero and Bill.com

When a Xero purchase order is read
Pulls Xero purchase orders with supplier, line items, and totals to match against the arriving bill.
Trigger·Invoice
When a Xero bank account is read
Pulls the bank-type accounts from the Xero chart of accounts with currency and account number.
Trigger·Account
When a Xero invoice is read
Pulls Xero sales and purchase invoices with contact, line items, totals, and tax.
Trigger·Invoice
When a Xero contact is read
Pulls Xero contacts with name, trading address, and tax number to match against your companies.
Trigger·Company
When a Xero payment is read
Reads the payment applied to a Xero invoice or bill with method, account, and amount.
Trigger·Payment method
When a Xero invoice attachment is read
Picks up the source PDF attached to a Xero invoice as a document.
Trigger·Document
When a Xero bank transaction is read
Captures spent and received money transactions reconciled in Xero with amount and account code.
Trigger·Transaction
When a Xero credit note is read
Captures Xero credit notes with contact, totals, and tax so refunds reconcile against the original invoice.
Trigger·Invoice
Attach the source PDF to the Bill.com bill
The forwarded PDF is the bill record itself in Bill.com's inbox.
Action·Document

Reference

Field mapping for Xero → Bill.com

15 fields across 3 record types, open to see the full table.

Invoice fields

7 fields flow from Xero into Bill.com.

Xero field	Label		Bill.com field	Label
Invoice.Total.total	Total	→	amount	Amount
Invoice.CurrencyCode.currency	Currency	→	currency	Currency
Invoice.Date.issue_date	Invoice date	→	invoice_date	Invoice date
Invoice.DueDate.due_date	Due date	→	due_date	Due date
Invoice.InvoiceNumber.invoice_number	Invoice number	→	invoice_number	Invoice number
Invoice.SubTotal.subtotal	Subtotal	→	subtotal	Subtotal
Invoice.InvoiceID.id	Xero id	→	external_id	External id

Transaction fields

5 fields flow from Xero into Bill.com.

Xero field	Label		Bill.com field	Label
BankTransaction.Total.amount	Amount	→	amount	Amount
BankTransaction.CurrencyCode.currency	Currency	→	currency	Currency
BankTransaction.Date.created	Transaction date	→	process_date	Process date
BankTransaction.Reference.description	Reference	→	memo	Memo
BankTransaction.BankTransactionID.transaction_id	Transaction id	→	payment_id	Payment id

Company fields

3 fields flow from Xero into Bill.com.

Xero field	Label		Bill.com field	Label
Contact.Name.name	Contact name	→	vendor_name	Vendor name
Contact.TaxNumber.tax_id	Tax number	→	tax_id	Tax id
Contact.ContactID.id	Contact id	→	vendor_id	Vendor id

Connect Xero and Bill.com in three steps.

1
Connect Xero
Click Connect with Xero; Well's OAuth proxy handles Xero authorisation through Dynamic Client Registration. Xero's MCP server registers a read-scoped Well client through DCR; no credential paste, no shared secret.
- AuthOAuth 2.0
2
Map your accounts
Well discovers Xero's bills, contacts, tracking categories, and tax types read over Xero's MCP server and the the Bill.com inbox awaiting approval. Match candidates are scored on counterparty, amount, date, and reference; above 85% confidence the link posts automatically, below it the candidate set queues for sign-off.
- Auto-post above85% confidence
- Overridemanual anytime
3
Connect Bill.com
In Bill.com, open Settings > Developer > API keys and create a key paired with your developer ID. Paste the key into Well; Bill.com's discovery endpoints are reached over TLS 1.3 and the secret is never echoed in the UI.
- AuthConnect
- First sync~10 min

How Xero and Bill.com stay secure with Well

Well connects to Xero through its MCP server, which issues short-lived access tokens via Dynamic Client Registration. Well never holds a long-lived Xero secret; the server refreshes its own tokens on each session. Well's storage region is configured per workspace regardless of where Xero and Bill.com host theirs.

MCP server authStorage region per workspaceGDPR-aligned

Scopes Well requestswellapp.ai/v1/mcps/xero/mcp

Read Xero records
Scoped to bills, contacts, tracking categories, and tax types read over Xero's MCP server. No access to anything else in your Xero account.
granted
Deliver documents to your Bill.com inbox
Well forwards the extracted document to your Bill.com email-in address; Bill.com reads bills via email-in inbox, with vendor, invoice number, amount, and related records from it and you review and post. No write credential to Bill.com is requested.
granted
Modify or delete Xero records
Not granted. Xero is read-only on Well's side; the source of truth never moves.
refused
Read other workspaces' data
Encryption keys are per-workspace; another tenant's records are inaccessible by design.
refused

Disconnect any time from Well settings or Xero’s admin panel.

Frequently asked questions about Xero and Bill.com on Well

01What Xero data does Well pull into Bill.com?: Xero streams bills, contacts, tracking categories, and tax types read over Xero's MCP server to Well over its MCP server. After Well resolves the counterparty and assigns a confidence score, the matched record posts to Bill.com as bills via email-in inbox, with vendor, invoice number, amount, and due date populated by Bill.com's IVA OCR, with the Xero event ID preserved on the entry for audit.
02Will every Xero record post to Bill.com automatically?: Not always. Within seconds of Xero firing the event, Well scores the record on field completeness, counterparty strength, and policy fit. Above the 85% default auto-link threshold Well forwards the reconciled document to your Bill.com email-in address and Bill.com drafts the record from it for you to confirm. Between 55% and 85% the record waits in the review queue with the alternative matches ranked. Below the 55% default review threshold the record is refused and the candidate list kept so you can pin the right entry by hand.
03How does Well match Xero records to entries in Bill.com?: Well scores every candidate match between Xero records and existing Bill.com entries on counterparty name, amount, date proximity, currency, and reference. Above 85% the record links to the historical entry and Bill.com updates; between 55% and 85% the candidates are queued for sign-off; below 55% the record stays open with the candidate list available.
04What happens to historical Xero data when I first connect to Bill.com?: Xero exposes seven years of accounting history through its API on a connected account. The window Well actually pulls is configurable from the integration settings page; each record is matched against your existing Bill.com ledger, and re-running the backfill is safe because Well tracks the Xero record IDs and updates existing Bill.com entries instead of duplicating them.
05Does Well handle multi-currency records between Xero and Bill.com?: Xero carries the original transaction currency on every record and Bill.com natively ledgers in multiple currencies. Well preserves the original amount, applies your Bill.com chart-of-accounts conversion rules at posting time, and both the source and converted amounts ride on the document Well forwards to Bill.com, so the Bill.com entry you post keeps both sides of the trade.
06How does Well authenticate with Xero and Bill.com?: Xero's MCP server handles authorisation directly; Well receives an access token through Dynamic Client Registration and never sees raw user credentials. For the delivery side, Well forwards the reconciled document to your Bill.com email-in address once it clears the matching threshold; Bill.com creates the draft record from it and you confirm and post it. Well holds no write credential to Bill.com. Tokens are encrypted at rest and in transit under TLS 1.3. Xero and Bill.com together cover multiple regions; Well's storage region is configured per workspace.