FreedomHub

Connect Outlook / Microsoft 365 to Your FreedomOS

Step-by-step integration guide
Updated April 2026

Why connect Outlook / Microsoft 365

Before you start

  • A Microsoft 365 or Outlook.com account
  • Azure Global Administrator access (or ask your IT admin to run the steps with you)
  • Your FreedomOS portal login
  • Approximately 15 minutes

Step-by-step

1

Open the Azure Portal

Go to https://portal.azure.com and sign in with your Microsoft 365 admin account.

[SCREENSHOT: Azure Portal home screen]
2

Open App Registrations

In the top search bar, type App registrations and open it. Click + New registration.

[SCREENSHOT: App registrations landing page with New registration button highlighted]
3

Register your app

Fill in the form:

  • Name: FreedomOS
  • Supported account types: Accounts in this organisational directory only (Single tenant)
  • Redirect URI: Web → https://n8nion8n-production-124b.up.railway.app/rest/oauth2-credential/callback

Click Register.

[SCREENSHOT: Register an application form filled with FreedomOS and redirect URI]
4

Copy the Application (client) ID and Tenant ID

From the app's Overview page, copy:

  • Application (client) ID
  • Directory (tenant) ID

Paste both into a temporary note — you'll need them in Step 8.

[SCREENSHOT: Overview page showing Application ID and Tenant ID fields]
5

Add API permissions

In the left menu, click API permissions → + Add a permission. Choose Microsoft Graph → Delegated permissions. Search for Mail.Send, tick it, and click Add permissions.

Optionally add Mail.ReadWrite if you want replies tracked in-portal later.

[SCREENSHOT: API permissions screen with Mail.Send selected]
6

Grant admin consent

Back on the API permissions page, click Grant admin consent for [your tenant] and confirm. Mail.Send should now show a green tick.

[SCREENSHOT: Grant admin consent button and green confirmation]
7

Create a client secret

In the left menu, click Certificates & secrets → + New client secret. Add a description (e.g. "FreedomOS"), choose expiry (24 months recommended), and click Add.

Copy the Value column immediately — it's only shown once. Paste it into your note alongside the Application ID and Tenant ID.

[SCREENSHOT: Client secret Value column highlighted right after creation]
8

Paste into FreedomOS and connect

In FreedomOS, go to Integrations → Outlook / Microsoft 365. Enter the three values below and click Connect Outlook. You'll be redirected to Microsoft to approve access — sign in with the same mailbox you want to send from.

Paste credentials

In FreedomOS, go to Integrations → Outlook / Microsoft 365. Enter the credentials below and click Connect.

Outlook / Microsoft 365 OAuth2 connection

Application (client) IDpaste from Step 4
Tenant IDpaste from Step 4
Client Secretpaste from Step 7
Redirect URIhttps://n8nion8n-production-124b.up.railway.app/rest/oauth2-credential/callback
PermissionMail.Send (delegated)

What happens next

Troubleshooting

AADSTS50011: Reply URL does not matchThe redirect URI registered on the app must be pasted exactly — including https:// and the full path ending in /callback. No trailing slash.
AADSTS65001: User or admin has not consentedGo back to API permissions and click Grant admin consent for [tenant]. Mail.Send needs the green tick before OAuth will succeed.
Invalid client secretSecrets expire. If your secret is past its expiry date, create a new one under Certificates & secrets and paste the new Value into FreedomOS.
Emails not sending after successful connectionReconnect from FreedomOS → Integrations → Outlook. Refresh tokens can lapse after prolonged inactivity or password changes.

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.