Why connect Sage
- Auto-sync customers, tax invoices and balances into FreedomOS
- Eliminate double-capture between Sage Business Cloud and your daily dashboard
- See outstanding debtors live alongside your sales pipeline
- Saves 3 to 6 hours per week on admin and reporting
Before you start
- Active Sage Business Cloud Accounting (One) subscription
- Admin access to the Sage company you want to connect
- Your FreedomOS portal login
- Approximately 8 minutes
Step-by-step
1
Sign in to Sage Business Cloud
Open your Sage Accounting dashboard and sign in with an admin user. In the top navigation, click the Settings cog icon.
[SCREENSHOT: Sage Business Cloud dashboard with Settings cog highlighted]
2
Open the Developer area
Inside Settings, scroll down to the Developer section and click API Keys.
[SCREENSHOT: Sage Settings panel with Developer and API Keys option]
3
Create a new API Key
Click New API Key. Give it a clear name such as "FreedomOS Integration" and set permissions to Full access. Click Save.
[SCREENSHOT: New API Key dialog with name and permissions fields]
4
Copy the API Key
Sage will reveal the key once. Copy it to a safe place immediately — you'll paste it into FreedomOS below.
[SCREENSHOT: API Key value revealed with copy icon]
5
Find your Company ID
Still in Settings, open About This Company. Your Company ID appears at the top of the page. Copy it.
[SCREENSHOT: About This Company screen with Company ID field]
6
Paste into FreedomOS and connect
In FreedomOS, go to Accounting → Integrations → Sage. Enter the credentials below and click Connect.
Paste credentials
In FreedomOS, go to Accounting → Integrations → Sage. Enter the credentials below and click Connect.
Sage connection
API Keypaste from Step 4
Company IDpaste from Step 5
What happens next
- Customers sync to your CRM within minutes
- Tax invoices pull into your invoice ledger
- Outstanding balances and ageing appear on the debtors dashboard
- Bank accounts and cash positions update daily
- Payments logged in FreedomOS post back to Sage
Troubleshooting
Invalid API KeySage API keys are case-sensitive. Re-copy without spaces at either end, or generate a new key and try again.
Wrong company showingIf you have multiple Sage companies, the Company ID must match exactly. Copy it from the About This Company page for the correct company.
Permissions deniedThe API Key must have Full access. Edit the key in Sage Developer settings and re-save.
Sync delayedSage rate-limits requests. Large historical imports can take up to 30 minutes on first connect — subsequent syncs run every 10 minutes.
If you run an accounting practice, see FreedomOS Accounting, done-for-you practice management for South African accounting firms.