company logo

Help center

Go to Smartlead.ai
API Documentation
All collectionsSetting Up Email AccountsHow To Set Up Your Email Network (OAuth) in Smartlead for Google

How To Set Up Your Email Network (OAuth) in Smartlead for Google

Learn how you can create Google OAuth and connect it with your Smartlead account.

Your Email Network lets you connect mailboxes through your own Google Cloud or Microsoft Azure OAuth app instead of Smartlead’s shared app. You control the credentials, satisfy strict security reviews, and sign every message with your app ID, boosting trust and deliverability.

Let’s look at how you can create an OAuth app in Google.

⚠ Before You Start

Please connect with your Smartlead Customer Success Manager (CSM) before creating your OAuth app. They’ll guide you through the steps to generate your Client ID and Client Secret correctly.

Mistakes here can affect your email deliverability and campaign performance, so we strongly recommend doing this with a CSM.

How To Create a Google Cloud OAuth App?

Step 1: Create a Project in Google Cloud

  1. Go to Google Cloud Console.

  2. Click the project dropdown on the top bar.

  3. Click “New Project”.

  4. Give your project a name (e.g. YourAgency Smartlead OAuth) and click Create

Step 2: Enable Gmail API

  1. Inside your new project, go to the left sidebar and click APIs & Services > Library.

  2. In the search bar, type “Gmail API”.

  3. Click on Gmail API.

  4. Click Enable.

Step 3: Configure OAuth Consent Screen

  • Go to APIs & Services > OAuth consent screen

  • In the OAuth overview, click on get started


  • Fill in the following details:

  • Give the app name and user support email, and click on next

    • App name: Your agency or business name

    • User support email: Your email address

    • Choose the Audience type to External and click on next.

    • Choose the email address and click on finish.


    • Navigate to clients

    • Click on Create clients


    • Choose the application type as a web application

    • Select the Name, it can be your brand name.

    • In the Authorized JavaScript origins, add:

      https://app.smartlead.ai

      https://yourwhitlabledurl (you can ignore if you don’t have any)

    • In the Authorized Redirect URLs, add:

      https://server.intellioauth.com/api/email-account/gmail/callback



    • Click on create

    • You will get the client id and client secret, please have it downloaded for your reference

    • Navigate to data access to add scopes:


    • Click Add or Remove Scopes

    • Add the following scopes:

      • https://www.googleapis.com/auth/userinfo.email

      • https://www.googleapis.com/auth/userinfo.profile

      • https://www.googleapis.com/auth/gmail.send

      • https://www.googleapis.com/auth/gmail.readonly

      • https://mail.google.com/

        Once the above scopes are added, click on save.

Step 4: Add Credentials in Smartlead

  1. In Smartlead, go to:

    • Settings > Google OAuth

  2. Paste your:

    • Client ID

    • Client Secret

  3. Click Save Credentials.

info icon
Setting up real-time inbox sync? If your integration requires real-time Gmail notifications, you'll also need to configure Google Cloud Pub/Sub in your project. See How to Set Up Google Cloud Pub/Sub for Real-Time Gmail Sync before connecting mailboxes.

Step 5: Connect Mailboxes Using Your OAuth

  1. Go to Email Accounts > Add Mailbox

  2. Select:

    • Your Email Network (for Smart and Prime users only)

    • Google OAuth

  3. Choose the mailbox and complete the connection.

Your mailbox is now connected using your own OAuth app, not Smartlead’s.

Similar to how you create Google OAuth, you can create Outlook OAuth too for setting up your own email network in Smartlead.👇

Set Up Microsoft Outlook OAuth

FAQs

Q. Can I switch back to Smartlead’s shared OAuth?

Yes - delete your custom provider in OAuth Configuration and reconnect mailboxes using Smartlead OAuth.

Q. Does Smartlead store my client secret?

Only momentarily for validation; it is never stored long‑term.


Did this answer your question?
😞
😐
😁