Skip to main content
Xero 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: 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.

​
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 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 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)
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:
1

Open the Xero developer portal

Sign in to My Apps with your Xero account.
2

Create a new app

Click New app, name it (for example, Lovable integration), and choose Web app as the integration type.
3

Set the redirect URI

In the app’s OAuth 2.0 configuration, set the redirect URI to exactly:
If the redirect URI doesn’t match exactly, Xero fails the authorization with an “Invalid redirect_uri” error.
4

Enable the scopes your connection needs

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.
5

Copy the credentials

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.

​
Step 2: Connect Xero to Lovable

You can create multiple connections using different Xero apps.
1

Open Xero in Connectors

Open Connectors and select Xero. For the other places to open the catalog from, see Where to find connectors.
2

Add a connection

Click Add connection.
3

Configure the 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.
4

Review scopes (optional)

Expand Advanced settings to review the permissions your app will request. Default scopes are pre-selected for common use cases.
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.
5

Choose who can use this connection

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 for more information.
6

Connect to Xero and authorize

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, 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, or deselect it under Advanced settings in Lovable, then try connecting again.

​
Manage your connection

Connections are managed from Connectors: select , then open the connection.
  • Unlink projects to remove access from specific projects while keeping the connection available for others. See 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 stop working until a new connection is added. See Delete a connection for the steps and who can delete.