---
title: "Connect your app to Xero"
description: "<p><a href=\"https://www.xero.com/\">Xero</a> is a cloud accounting platform for managing contacts, invoices, bills, payments, and bookkeeping workflows."
---

> Documentation Index
> Fetch the complete documentation index at: https://rshift.helpcent.re/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your app to Xero

<p><a href="https://www.xero.com/">Xero</a> is a cloud accounting platform for managing contacts, invoices, bills, payments, and bookkeeping workflows. The Xero connector lets your RShift Sites app work with the accounting data in your Xero organization through a Xero app you register. It's designed for finance dashboards, invoicing workflows, and internal operations tools built on Xero data.</p>
<p>Xero is available as an <a href="/sites/integrations/app-connectors/">app + chat connector</a>: one shared connection that works in the project chat while you build and in your published apps.</p>
<p>With Xero, your app can:</p>
<ul>
<li>Read and manage contacts, including customers and suppliers</li>
<li>Create, update, and read sales invoices and bills</li>
<li>Record and read payments and bank transactions</li>
<li>Read organization settings, currencies, and tax rates</li>
<li>Read financial reports such as profit and loss, balance sheet, and aged receivables and payables</li>
</ul>
<p>A connection reaches the Xero organization you choose during authorization, and RShift Sites looks up its ID for you. It's a good fit for receivables dashboards, billing portals, expense trackers, and reporting apps that need live accounting data.</p>
<h2>Common use cases and example apps</h2>
<p>These examples show what you can build with Xero, each with a prompt to start from.</p>
<table>
<thead>
<tr>
<th style="text-align: left">Example app</th>
<th style="text-align: left">Example prompt</th>
<th style="text-align: left">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left"><strong>Receivables dashboard</strong></td>
<td style="text-align: left"><em>Use Xero and build a dashboard that shows open invoices, overdue balances, and aged receivables by customer.</em></td>
<td style="text-align: left"><strong>Track outstanding revenue from Xero in one place.</strong><br />The app reads invoices, payments, and the aged receivables report, then highlights the customers that need follow-up.</td>
</tr>
<tr>
<td style="text-align: left"><strong>Invoice creation workflow</strong></td>
<td style="text-align: left"><em>Use Xero and build a form that creates a draft sales invoice in Xero from an approved internal request.</em></td>
<td style="text-align: left"><strong>Turn internal approvals into Xero invoices.</strong><br />The app collects request details, looks up the right contact, and creates the invoice in the connected Xero organization.</td>
</tr>
<tr>
<td style="text-align: left"><strong>Supplier bill tracker</strong></td>
<td style="text-align: left"><em>Use Xero and build a bill tracker that lists upcoming and overdue bills grouped by supplier.</em></td>
<td style="text-align: left"><strong>Give finance teams a focused view of payables.</strong><br />The app reads bills and payments from Xero and shows what is due, what is paid, and what is overdue.</td>
</tr>
<tr>
<td style="text-align: left"><strong>Cash flow monitor</strong></td>
<td style="text-align: left"><em>Use Xero and build an app that shows recent bank transactions and compares money in against money out per month.</em></td>
<td style="text-align: left"><strong>Watch cash movement without opening Xero.</strong><br />The app reads bank transactions and payments, then charts inflows and outflows over time.</td>
</tr>
<tr>
<td style="text-align: left"><strong>Financial reporting portal</strong></td>
<td style="text-align: left"><em>Use Xero and build a portal that shows the latest profit and loss and balance sheet reports to stakeholders.</em></td>
<td style="text-align: left"><strong>Share key financial reports in a read-only view.</strong><br />The app fetches the profit and loss and balance sheet reports from Xero and renders them for people who don't have Xero access.</td>
</tr>
<tr>
<td style="text-align: left"><strong>Customer account tool</strong></td>
<td style="text-align: left"><em>Use Xero and build a tool where staff can search customers and view their contact details and invoice history.</em></td>
<td style="text-align: left"><strong>Make Xero customer data easy to look up.</strong><br />The app reads contacts and their invoices from Xero and gives support and sales teams a quick account overview.</td>
</tr>
</tbody>
</table>
<h2>How to connect Xero</h2>
<p>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: <a href="/sites/integrations/admin-controls/#who-can-create-connections-and-clients">Who can create connections and clients</a> defaults to <strong>No one</strong> until an admin changes it in <strong>Connectors → Admin settings → App + chat connectors</strong>.</p>
<p>You can create multiple Xero connections using different Xero apps or accounts, which is useful for separating environments or managing multiple businesses.</p>
<p>When the connection is created, you can <a href="/sites/integrations/app-connectors/#link-a-connection-to-a-project">link it to the projects</a> where you want to use it. Anyone building in a project can ask RShift Sites in the project chat to link their project to it.</p>
<h3>Prerequisites</h3>
<p>Before connecting Xero, make sure you have:</p>
<ul>
<li>A Xero account with access to the organization you want to connect</li>
<li>A Xero app with a client ID and client secret (you create this in Step 1)</li>
<li>Permission to <strong>create connections</strong> in your RShift Sites workspace (see <a href="/sites/integrations/admin-controls/#who-can-create-connections-and-clients">Who can create connections and clients</a>)</li>
</ul>
<blockquote>
<p><strong>Note</strong></p>
<p>All API requests made through this connector run through your own Xero app and count toward Xero's rate limits. Billing and quota are handled directly by Xero, not RShift Sites.</p>
</blockquote>
<h3>Step 1: Create a Xero app</h3>
<p>The connector authenticates through your own Xero app, so you need a client ID and client secret before connecting.</p>
<p>To create a Xero app:</p>
<p><strong>Open the Xero developer portal</strong></p>
<p>Sign in to <a href="https://developer.xero.com/app/manage">My Apps</a> with your Xero account.</p>
<p><strong>Create a new app</strong></p>
<p>Click <strong>New app</strong>, name it (for example, <code>RShift Sites integration</code>), and choose <strong>Web app</strong> as the integration type.</p>
<p><strong>Set the redirect URI</strong></p>
<p>In the app's OAuth 2.0 configuration, set the redirect URI to exactly:</p>
<pre><code class="language-text">https://api.lovable.dev/workspaces/connectors/standard/oauth/callback
</code></pre>
<pre><code>The connection form in RShift Sites shows the same value in a **Redirect URI** card with a copy button. If the redirect URI doesn't match exactly, Xero fails the authorization with an "Invalid redirect\_uri" error.
</code></pre>
<p><strong>Enable the scopes your connection needs</strong></p>
<p>On the app's <strong>Configuration</strong> page, enable every scope you plan to select in RShift Sites. Xero apps created after March 2026 support only granular scopes, and Xero rejects the entire authorization if RShift Sites requests a scope that isn't enabled on the app.</p>
<p><strong>Copy the credentials</strong></p>
<p>On the <strong>Configuration</strong> page, copy the <strong>Client id</strong> (a 32-character code) and generate a <strong>Client secret</strong>. Copy both and store them securely. You'll need them in the next step.</p>
<blockquote>
<p><strong>Danger</strong></p>
<p>Your client secret functions like a password. Keep it secure and never share it publicly.</p>
</blockquote>
<p>See Xero documentation for more: <a href="https://developer.xero.com/documentation/guides/oauth2/overview/">Xero OAuth 2.0 guide</a>.</p>
<h3>Step 2: Connect Xero to RShift Sites</h3>
<p>You can create multiple connections using different Xero apps.</p>
<p><strong>Open Xero in Connectors</strong></p>
<p>Open <a href="https://lovable.dev/dashboard?connectors"><strong>Connectors</strong></a> and select <strong>Xero</strong>. For the other places to open the catalog from, see <a href="/sites/integrations/introduction/#where-to-find-connectors">Where to find connectors</a>.</p>
<p><strong>Add a connection</strong></p>
<p>Click <strong>Add connection</strong>.</p>
<p><strong>Configure the connection</strong></p>
<ol>
<li><strong>Display name</strong>: name the connection, for example <code>Xero Prod</code>. This name is only used inside RShift Sites to identify the connection.</li>
<li><strong>Client ID</strong>: paste the client ID from your Xero app.</li>
<li><strong>Client Secret</strong>: paste the client secret you generated.</li>
</ol>
<p><strong>Review scopes (optional)</strong></p>
<p>Under <strong>Scopes</strong>, review the permissions the connection requests. <strong>Refresh access</strong>, <strong>Organisation settings</strong>, <strong>Contacts</strong>, and <strong>Invoices &amp; bills</strong> are always included. Payments, bank transactions, and the profit and loss, balance sheet, and aged reports are selected by default.</p>
<pre><code>| Scope                                                                 | Description                                                                | Default  |
| --------------------------------------------------------------------- | -------------------------------------------------------------------------- | -------- |
| Refresh access (`offline_access`)                                     | Keep the Xero connection working without asking you to reconnect           | Required |
| Organisation settings (`accounting.settings`)                         | Read organisation settings, currencies, tracking categories, and tax rates | Required |
| Contacts (`accounting.contacts`)                                      | Read and manage customers and suppliers                                    | Required |
| Invoices &amp; bills (`accounting.invoices`)                              | Read and manage sales invoices and bills                                   | Required |
| Payments (`accounting.payments`)                                      | Read and manage payments applied to invoices and bills                     | On       |
| Bank transactions (`accounting.banktransactions`)                     | Read and manage bank transactions                                          | On       |
| Manual journals (`accounting.manualjournals`)                         | Read and manage manual journals                                            | Off      |
| Attachments (`accounting.attachments`)                                | Read and manage attachments on invoices, bills, and other documents        | Off      |
| 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 &amp; payables reports (`accounting.reports.aged.read`)  | Read aged receivables and aged payables reports                            | On       |
| 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 and budget lines                                              | Off      |
</code></pre>
<blockquote>
<p><strong>Danger</strong></p>
<p>Every scope you select here must also be enabled on your Xero app's <strong>Configuration</strong> page. If a selected scope isn't enabled on the app, Xero rejects the authorization with a "Requested wrong apps scopes" error.</p>
</blockquote>
<pre><code>For full scope documentation, see [Xero's scope reference](https://developer.xero.com/documentation/guides/oauth2/scopes/).
</code></pre>
<p><strong>Choose who can use this connection</strong></p>
<p>Under <strong>Sharing</strong>, the connection is private to you by default and shows a <strong>Private</strong> label. To share it, click <strong>Share with others</strong>. Then add workspace members by email, or click <strong>Invite entire workspace</strong> to make the connection available to everyone in your RShift Sites workspace.</p>
<pre><code>See [Who can use connections and clients](/sites/integrations/admin-controls/#who-can-use-connections-and-clients) for more information.
</code></pre>
<p><strong>Connect to Xero and authorize</strong></p>
<p>Click <strong>Connect</strong>. The Xero authorization window opens, so make sure your browser doesn't block pop-ups. If it does, RShift Sites redirects you instead.</p>
<pre><code>Sign in to Xero if prompted, choose the organization you want to grant access to, and authorize the app.

You'll be redirected back to RShift Sites with a confirmation.
</code></pre>
<p>When connected, anyone building in a project can ask RShift Sites in the project chat to link their project to Xero (based on configured connection-level access). Your RShift Sites apps can then work with Xero contacts, invoices, bills, payments, bank transactions, and financial reports.</p>
<h2>Limitations</h2>
<p>The Xero connector cannot:</p>
<ul>
<li>Use Xero's umbrella scopes such as <code>accounting.transactions</code> or <code>accounting.reports.read</code>. Select the granular scopes instead.</li>
<li>Support per-end-user Xero login. Each connection represents a single Xero account shared across all projects linked to it.</li>
</ul>
<p>If Xero authorization is revoked from the Xero side, reconnect the connection in RShift Sites before API calls can succeed again.</p>
<h2>Troubleshooting</h2>
<p>If connecting to Xero fails, the sections below cover the most common errors and how to resolve them.</p>
<p><strong>Xero shows "Invalid redirect_uri" during authorization</strong></p>
<p>The redirect URI on your Xero app doesn't exactly match the one RShift Sites uses. Open <a href="https://developer.xero.com/app/manage">My Apps</a>, select your app, and set the redirect URI to exactly <code>https://api.lovable.dev/workspaces/connectors/standard/oauth/callback</code>, then try connecting again.</p>
<p><strong>Xero shows "Requested wrong apps scopes" during authorization</strong></p>
<p>A scope selected on your RShift Sites connection isn't enabled on your Xero app. Either enable the missing scope on the app's <strong>Configuration</strong> page in <a href="https://developer.xero.com/app/manage">My Apps</a>, or deselect it under <strong>Scopes</strong> in RShift Sites, then try connecting again.</p>
<h2>Manage your {connector_0} connection</h2>
<p>Connections are managed from <a href="https://lovable.dev/dashboard?connectors"><strong>Connectors</strong></a>: select <strong>{connector_0}</strong>, then open the connection.</p>
<ul>
<li><strong>Unlink projects</strong> to remove {connector_0} access from specific projects while keeping the connection available for others. See <a href="/sites/integrations/app-connectors/#unlink-projects-from-a-connection">Unlink projects from a connection</a> for the steps.</li>
<li><strong>Delete the connection</strong> 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 <a href="/sites/integrations/app-connectors/#delete-a-connection">Delete a connection</a> for the steps and who can delete.</li>
</ul>
<h2>Related topics</h2>
<ul>
<li><a href="/sites/integrations/workday/">Connect your app to Workday</a></li>
<li><a href="/sites/integrations/notion/">Connect your app to Notion</a></li>
<li><a href="/sites/integrations/granola/">Connect your app to Granola</a></li>
<li><a href="/sites/integrations/slack/">Connect your app to Slack</a></li>
<li><a href="/sites/integrations/inngest/">Connect your app to Inngest</a></li>
</ul>

Source: https://rshift.helpcent.re/sites/integrations/xero/index.mdx
