Why connect Xero
- Auto-sync invoices, contacts and bank transactions into your FreedomOS dashboard
- Eliminate manual data entry between Xero and your client workflow
- See live profit and loss numbers alongside your pipeline and tasks
- Saves 4 to 8 hours per week on reconciliation and reporting
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
- Invoices sync both ways within 5 minutes of any change
- Contacts and customer details pull into your CRM automatically
- Bank transactions appear in the cash-flow dashboard
- Monthly P&L updates live on your home screen
- Tax invoices raised in FreedomOS post directly to Xero
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.
If you run an accounting practice, see FreedomOS Accounting, done-for-you practice management for South African accounting firms.