FreedomHub

Connect Xero to Your FreedomOS

Step-by-step integration guide
Updated April 2026

Why connect Xero

Before you start

  • An active Xero subscription with admin access
  • Your FreedomOS portal login
  • A Xero developer account (free — created in Step 1)
  • Approximately 10 minutes

Step-by-step

1

Open the Xero developer portal

Sign in with the same email you use for Xero at https://developer.xero.com/app/manage

Click New app in the top right.

[SCREENSHOT: Xero developer dashboard with New app button highlighted]
2

Create the app

Fill in the form:

  • App name: FreedomOS
  • Integration type: Web app
  • Company URL: your business website
  • Redirect URI: http://localhost:8742/callback

Accept the terms and click Create app.

[SCREENSHOT: New app form filled in with Redirect URI field visible]
3

Copy your Client ID

On the app's Configuration tab, copy the Client id value. Keep this tab open — you'll paste it into FreedomOS in a moment.

[SCREENSHOT: Configuration tab showing Client id field]
4

Generate a Client Secret

On the same Configuration page, click Generate a secret. Copy the secret the moment it appears — Xero only shows it once.

[SCREENSHOT: Generate a secret button and the revealed secret value]
5

Set the scopes

When FreedomOS requests permission during first connect, tick these scopes:

  • accounting.transactions
  • accounting.contacts
  • accounting.reports.read
[SCREENSHOT: Xero consent screen with scopes ticked]
6

Paste into FreedomOS and connect

In FreedomOS, go to Accounting → Integrations → Xero. Enter the credentials below and click Connect.

Paste credentials

In FreedomOS, go to Accounting → Integrations → Xero. Enter the credentials below and click Connect.

Xero connection

Client IDpaste from Step 3
Client Secretpaste from Step 4
Redirect URIhttp://localhost:8742/callback
Scopesaccounting.transactions, accounting.contacts, accounting.reports.read

What happens next

Troubleshooting

Redirect URI mismatchCopy the Redirect URI exactly — including http://, the port 8742, and /callback. No trailing slash.
Lost the Client SecretGo back to the app's Configuration tab and click Generate a secret again. Update the value in FreedomOS.
Connection keeps expiringXero refresh tokens last 60 days. FreedomOS refreshes silently as long as the integration is active — if you haven't opened it in 60 days, reconnect.
Missing organisationDuring consent, select the correct Xero organisation from the dropdown. If you manage several, you can connect each one as a separate workspace.

Need help

We're here for you

Email info@freedomhub.io or WhatsApp 066 075 5010

If you run an accounting practice, see FreedomOS Accounting, done-for-you practice management for South African accounting firms.