Skip to content

Provider apps ​

Xero, QuickBooks, Google and Microsoft only talk to apps registered with them. There are two ways to do that:

  • One app for the whole install. You register it once and put its client ID and secret in the environment. Every business then connects with a single sign-in, and the assistant can set the connection up from the chat. Use this when you run Rangefront Waste for more than one business.
  • An app per business. The business registers its own app and pastes the client ID and secret into its connection in Admin > Integrations. Use this when one business runs its own install and you'd rather not hold an app for it.

Both work at once. A connection that has its own client ID uses it, and every other connection uses the install's app.

<!-- subscription:start --> The hosted subscription uses one app per provider, owned by Rangefront Labs. Businesses on it never make an app, and the client secrets live only in Railway and the "Rangefront Waste production secrets" item in 1Password. <!-- subscription:end -->

Xero ​

  1. Sign in at developer.xero.com with the account that should own the app. Choose New app, then Web app.
  2. Name it after the product people see, since that name is on the Xero consent screen. Set the company or application URL to your public site.
  3. Add the redirect URI APP_URL/api/v1/integrations/oauth/xero/callback, using the API's address, for example https://api.example.com/api/v1/integrations/oauth/xero/callback. It must match exactly.
  4. Under Configuration, generate a client secret. Copy the client ID and secret into XERO_CLIENT_ID and XERO_CLIENT_SECRET.
  5. Under Webhooks, tick Contacts, Invoices, Credit notes and Payments, and set the delivery URL to APP_URL/api/v1/webhooks/xero. Save, copy the webhook key into XERO_WEBHOOK_KEY, restart the app, then choose "Send 'Intent to receive'" in Xero. It passes once the key is loaded. Webhooks are optional: without them, payments and customers still come in on the hourly and daily syncs.
  6. Restart the API and queue workers so they read the new settings. Admin > Integrations then stops asking businesses for an app, and the assistant offers to connect Xero.

Rangefront asks Xero for offline_access accounting.invoices accounting.payments accounting.contacts accounting.settings. These are the narrower scopes Xero gives apps created after 2 March 2026.

Limits ​

  • A new Xero app can connect up to 25 organisations. Past that it needs Xero's app partner certification, which takes a few months and wants a few active customer connections first. Apply well before you reach 25. Connections to Xero's demo company don't count.
  • Xero allows 60 calls a minute and 5,000 a day for each organisation. Rangefront batches its reads to stay inside that.
  • Xero's current developer plans also cap connections and monthly data by tier. Check the plan on the app's Manage Plan page.

Keep the secret safe ​

The client secret lets anyone holding it act as your app. Keep it in the environment only. Rangefront never stores the install's secret on a connection, never shows it in the console, and won't send it anywhere but Xero's own sign-in address, even if a connection's settings point elsewhere. If it leaks, generate a new one in Xero and update XERO_CLIENT_SECRET. Existing connections keep working, because their tokens aren't tied to the secret.

Other providers ​

Each has the same pair: QUICKBOOKS_CLIENT_ID and QUICKBOOKS_CLIENT_SECRET, and likewise GOOGLE_CALENDAR_ and MICROSOFT_365_. Register APP_URL/api/v1/integrations/oauth/<provider>/callback as the redirect address, with quickbooks, google_calendar or microsoft_365 in place of <provider>.

ProviderWhere to registerNotes
QuickBooks Onlinedeveloper.intuit.comUse the production keys, not the sandbox ones. Intuit reviews an app before other businesses can use it
Google Calendarconsole.cloud.google.comAn OAuth client of type Web application. Google verifies apps that ask for calendar access
Microsoft 365entra.microsoft.comA multitenant app registration with a web redirect

Check it ​

  1. Open Admin > Integrations, add the provider, and confirm the sheet no longer asks for a client ID.
  2. Choose Connect, sign in to a test or demo account at the provider, and approve.
  3. Use Test connection. For Xero it reports the organisation's name.