FreedomHub

Connect Sage One to Your FreedomOS

Step-by-step integration guide
Updated April 2026

Why connect Sage

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

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.

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.