Why connect Gmail
- All FreedomOS emails send from your real Gmail address — not a generic system inbox
- Replies land in your Gmail, conversations stay threaded
- Better deliverability — clients see your domain, not a relay
- Saves hours a week by letting the portal send quotes, invoices, and follow-ups on your behalf
Before you start
- A Google account (personal Gmail or Google Workspace)
- Admin access if you're on Google Workspace
- Your FreedomOS portal login
- Approximately 12 minutes
Step-by-step
1
Open Google Cloud Console
Go to https://console.cloud.google.com and sign in with the Google account you want to send from.
[SCREENSHOT: Google Cloud Console home screen]
2
Create a new project
Click the project selector at the top, then New Project. Name it "FreedomOS" and click Create.
[SCREENSHOT: New Project dialog with FreedomOS name entered]
3
Enable the Gmail API
In the left menu, go to APIs & Services → Library. Search for Gmail API and click Enable.
[SCREENSHOT: Gmail API enablement screen]
4
Configure the OAuth consent screen
Go to APIs & Services → OAuth consent screen. Choose External, then fill in:
- App name: FreedomOS
- User support email: your email
- Developer contact: your email
Save and continue. On the Scopes step, add https://www.googleapis.com/auth/gmail.send.
[SCREENSHOT: OAuth consent screen with scopes configured]
5
Create OAuth2 credentials
Go to APIs & Services → Credentials. Click Create credentials → OAuth client ID. Choose Web application and set:
- Name: FreedomOS Gmail
- Authorised redirect URI:
https://n8nion8n-production-124b.up.railway.app/rest/oauth2-credential/callback
Click Create.
[SCREENSHOT: OAuth client creation form with Web application type and redirect URI]
6
Copy the Client ID and Client Secret
Google displays both values in a modal. Copy them immediately and keep them safe.
[SCREENSHOT: OAuth client created dialog with Client ID and Secret fields]
7
Add yourself as a test user
Back in OAuth consent screen, scroll to Test users and click Add users. Enter your Gmail address and save.
[SCREENSHOT: Test users section with email added]
8
Paste into FreedomOS and connect
In FreedomOS, go to Integrations → Gmail. Enter the credentials below and click Connect. You'll be redirected to Google to approve access — sign in with the same Gmail address.
Paste credentials
In FreedomOS, go to Integrations → Gmail. Enter the credentials below and click Connect.
Gmail OAuth2 connection
Client IDpaste from Step 6
Client Secretpaste from Step 6
Redirect URIhttps://n8nion8n-production-124b.up.railway.app/rest/oauth2-credential/callback
Scopehttps://www.googleapis.com/auth/gmail.send
What happens next
- All FreedomOS outbound emails send from your Gmail address
- Quotes, invoices, and reminders send automatically on your behalf
- Sent mail appears in your Gmail Sent folder
- Replies land in your normal inbox and keep threading
- Deliverability improves — no spoofing, no third-party relays
Troubleshooting
Access blocked: app not verifiedWhile the app is in Testing mode, only addresses listed under Test users can connect. Add your Gmail as a test user and try again.
Redirect URI mismatchThe redirect URI must be pasted exactly — including https:// and the full path ending in /callback. No trailing slash.
Invalid scopeConfirm you added https://www.googleapis.com/auth/gmail.send on the OAuth consent Scopes page, not just enabled the Gmail API.
Emails not sendingReconnect from FreedomOS → Integrations → Gmail. Google access tokens can lapse after 7 days while the app is in Testing mode.