> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect your app to Xero
> Connect your app to Xero, a cloud accounting platform, to work with contacts, invoices, bills, payments, bank transactions, and financial reports.
export const connector_0 = "Xero"
[Xero](https://www.xero.com/) is a cloud accounting platform for managing contacts, invoices, bills, payments, and bookkeeping workflows. The Xero connector lets your Lovable app work with the accounting data in your Xero organisation through your own Xero app. It's designed for finance dashboards, invoicing workflows, and internal operations tools built on Xero data.
Xero is available as an [app + chat connector](/integrations/app-connectors): one shared connection that works in the chat while you build and in your published apps.
With Xero, your app can:
* Read and manage contacts, including customers and suppliers
* Create, update, and read sales invoices and bills
* Record and read payments and bank transactions
* Read organisation settings, currencies, and tax rates
* Read financial reports such as profit and loss, balance sheet, and aged receivables and payables
A connection can access the Xero organisations you consent to during authorization, and Lovable discovers the connected organisations automatically. It's a good fit for receivables dashboards, billing portals, expense trackers, and reporting apps that need live accounting data.
## Common use cases and example apps
Use Xero when your Lovable app needs live accounting data such as contacts, invoices, bills, payments, or financial reports from your Xero organisation.
| Example app | Example prompt | Description |
| :------------------------- | :----------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Receivables dashboard | *Use Xero and build a dashboard that shows open invoices, overdue balances, and aged receivables by customer.* | **Track outstanding revenue from Xero in one place.**
The app reads invoices, payments, and the aged receivables report, then highlights the customers that need follow-up. |
| Invoice creation workflow | *Use Xero and build a form that creates a draft sales invoice in Xero from an approved internal request.* | **Turn internal approvals into Xero invoices.**
The app collects request details, looks up the right contact, and creates the invoice in the connected Xero organisation. |
| Supplier bill tracker | *Use Xero and build a bill tracker that lists upcoming and overdue bills grouped by supplier.* | **Give finance teams a focused view of payables.**
The app reads bills and payments from Xero and shows what is due, what is paid, and what is overdue. |
| Cash flow monitor | *Use Xero and build an app that shows recent bank transactions and compares money in against money out per month.* | **Watch cash movement without opening Xero.**
The app reads bank transactions and payments, then charts inflows and outflows over time. |
| Financial reporting portal | *Use Xero and build a portal that shows the latest profit and loss and balance sheet reports to stakeholders.* | **Share key financial reports in a read-only view.**
The app fetches the profit and loss and balance sheet reports from Xero and renders them for people who don't have Xero access. |
| Customer account tool | *Use Xero and build a tool where staff can search customers and view their contact details and invoice history.* | **Make Xero customer data easy to look up.**
The app reads contacts and their invoices from Xero and gives support and sales teams a quick account overview. |
## How to connect Xero
Who can create Xero connections depends on your plan and workspace settings. App + chat connectors are available by default on Free, Pro, and Business plans. On Enterprise plans, they are effectively disabled at first: [Who can create connections and clients](/integrations/admin-controls#who-can-create-connections-and-clients) defaults to **No one** until an admin changes it in **Connectors → Admin settings → App + chat connectors**.
You can create multiple Xero connections using different Xero apps or accounts, which is useful for separating environments or managing multiple businesses.
When the connection is created, you can [link it to the projects](/integrations/app-connectors#link-a-connection-to-a-project) where you want to use it. Anyone building in a project can ask Lovable in chat to link their project to it.
### Prerequisites
Before connecting Xero, make sure you have:
* A Xero account with access to the organisation you want to connect
* A Xero app with a client ID and client secret (you create this in Step 1)
* Permission to **create connections** in your Lovable workspace (see [Who can create connections and clients](/integrations/admin-controls#who-can-create-connections-and-clients))
All API requests made through this connector run against your own Xero app and count toward Xero's rate limits. Billing and quota are handled directly by Xero, not Lovable.
### Step 1: Create a Xero app
The connector authenticates through OAuth using your own Xero app, so you need a client ID and client secret before connecting.
To create a Xero app:
Sign in to [My Apps](https://developer.xero.com/app/manage) with your Xero account.
Click **New app**, name it (for example, `Lovable integration`), and choose **Web app** as the integration type.
In the app's OAuth 2.0 configuration, set the redirect URI to exactly:
```text theme={null}
https://api.lovable.dev/workspaces/connectors/standard/oauth/callback
```
If the redirect URI doesn't match exactly, Xero fails the authorization with an "Invalid redirect\_uri" error.
On the app's **Configuration** page, enable every scope you plan to select in Lovable. Xero apps created after March 2026 support only granular scopes, and Xero rejects the entire authorization if Lovable requests a scope that isn't enabled on the app.
On the **Configuration** page, copy the **Client id** (a 32-character code) and generate a **Client secret**. Copy both and store them securely. You need them in the next step.
Your client secret functions like a password. Keep it secure and never share it publicly.
See Xero's documentation for more: [Xero OAuth 2.0 guide](https://developer.xero.com/documentation/guides/oauth2/overview/).
### Step 2: Connect Xero to Lovable
You can create multiple connections using different Xero apps.
Open [**Connectors**](https://lovable.dev/dashboard?connectors) and select **Xero**. For the other places to open the catalog from, see [Where to find connectors](/integrations/introduction#where-to-find-connectors).
Click **Add connection**.
1. **Display name**: name the connection, for example `Xero Prod`. This name is only used inside Lovable to identify the connection.
2. **Client ID**: paste the client ID from your Xero app.
3. **Client Secret**: paste the client secret you generated.
Expand **Advanced settings** to review the permissions your app will request. Default scopes are pre-selected for common use cases.
| Scope | Description | Default |
| --------------------------------------------------------------------- | ------------------------------------------------- | -------- |
| Refresh access (`offline_access`) | Keeps the connection working without reconnecting | Required |
| Organisation settings (`accounting.settings`) | Organisation details, currencies, and tax rates | Required |
| Contacts (`accounting.contacts`) | Customers and suppliers | Required |
| Invoices & bills (`accounting.invoices`) | Sales invoices and bills | Required |
| Payments (`accounting.payments`) | Payments against invoices and bills | On |
| Bank transactions (`accounting.banktransactions`) | Spend and receive money transactions | On |
| Profit and loss report (`accounting.reports.profitandloss.read`) | Read the profit and loss report | On |
| Balance sheet report (`accounting.reports.balancesheet.read`) | Read the balance sheet report | On |
| Aged receivables & payables reports (`accounting.reports.aged.read`) | Read aged receivables and payables reports | On |
| Manual journals (`accounting.manualjournals`) | Manual journal entries | Off |
| Attachments (`accounting.attachments`) | File attachments on accounting records | Off |
| Executive summary report (`accounting.reports.executivesummary.read`) | Read the executive summary report | Off |
| Bank summary report (`accounting.reports.banksummary.read`) | Read the bank summary report | Off |
| Trial balance report (`accounting.reports.trialbalance.read`) | Read the trial balance report | Off |
| Budget summary report (`accounting.reports.budgetsummary.read`) | Read the budget summary report | Off |
| Budgets (`accounting.budgets.read`) | Read budgets | Off |
Every scope you select here must also be enabled on your Xero app's **Configuration** page. If a selected scope isn't enabled on the app, Xero rejects the authorization with a "Requested wrong apps scopes" error.
For full scope documentation, see [Xero's scope reference](https://developer.xero.com/documentation/guides/oauth2/scopes/).
Under **Who can use this connection**, decide who in your workspace can use the connection. You start as the only person with access:
* **Only you** (default): leave the access list as is; only you can use the connection and its associated data.
* **Invite specific people**: add workspace members by email; only you and the people you add can use the connection and its associated data.
* **Invite entire workspace**: click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.
See [Who can use connections and clients](/integrations/admin-controls#who-can-use-connections-and-clients) for more information.
Click **Connect**. The Xero authorization window opens, so make sure your browser doesn't block pop-ups. If it does, Lovable redirects you instead.
Sign in to Xero if prompted, choose the organisation you want to grant access to, and click **Allow access**.
You'll be redirected back to Lovable with a confirmation.
When connected, anyone building in a project can ask Lovable in chat to link their project to Xero (based on configured connection-level access). Your Lovable apps can then work with Xero contacts, invoices, bills, payments, bank transactions, and financial reports.
## Limitations
The Xero connector cannot:
* Write data outside the scopes selected on the connection. The report scopes are read-only.
* Use Xero's umbrella scopes such as `accounting.transactions` or `accounting.reports.read`. Select the granular scopes instead.
* Support per-end-user Xero login. Each connection represents a single Xero account shared across all projects linked to it.
If Xero authorization is revoked from the Xero side, you'll need to reconnect the integration in Lovable before API calls can succeed again.
## Troubleshooting
If connecting to Xero fails, the sections below cover the most common errors and how to resolve them.
The redirect URI on your Xero app doesn't exactly match the one Lovable uses. Open [My Apps](https://developer.xero.com/app/manage), select your app, and set the redirect URI to exactly `https://api.lovable.dev/workspaces/connectors/standard/oauth/callback`, then try connecting again.
A scope selected on your Lovable connection isn't enabled on your Xero app. Either enable the missing scope on the app's **Configuration** page in [My Apps](https://developer.xero.com/app/manage), or deselect it under **Advanced settings** in Lovable, then try connecting again.
## Manage your {connector_0} connection
Connections are managed from [**Connectors**](https://lovable.dev/dashboard?connectors): select **{connector_0}**, then open the connection.
* **Unlink projects** to remove {connector_0} access from specific projects while keeping the connection available for others. See [Unlink projects from a connection](/integrations/app-connectors#unlink-projects-from-a-connection) for the steps.
* **Delete the connection** to remove it from the workspace entirely. Deleting is permanent. It removes the credentials from all linked projects, and app features that use {connector_0} stop working until a new connection is added. See [Delete a connection](/integrations/app-connectors#delete-a-connection) for the steps and who can delete.