FreedomHub

Connect Gmail to Your FreedomOS

Step-by-step integration guide
Updated April 2026

Why connect Gmail

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

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.

Need help

We're here for you

Email info@freedomhub.io or WhatsApp 066 075 5010