Why connect Outlook / Microsoft 365
- All FreedomOS emails send from your real Microsoft mailbox — not a generic relay
- Replies land in Outlook, conversations stay threaded with your client history
- Full compliance — the mail passes through your tenant with your retention and DLP policies
- Saves hours a week by letting the portal send quotes, invoices, and follow-ups automatically
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
- All FreedomOS outbound emails send from your Outlook / Microsoft 365 address
- Quotes, invoices, and reminders send automatically on your behalf
- Sent mail appears in your Outlook Sent Items folder
- Replies land in your Outlook inbox and keep threading
- Your tenant's compliance, retention, and DLP policies apply to all sent mail
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.
If you run an accounting practice, see FreedomOS Accounting, done-for-you practice management for South African accounting firms.