---
title: "Gmail/Google oAuth 1 Click Authentication"
description: "1-Click Gmail/Google oAuth Guide for Smartlead. Seamlessly authenticate email accounts with Google oAuth- Smartlead"
url: https://helpcenter.smartlead.ai/en/articles/18-gmailgoogle-oauth-1-click-authentication
collection: "Setting Up Email Accounts"
updated: 2026-11-12
language: en
---

# Gmail/Google oAuth 1 Click Authentication

1-Click Gmail/Google oAuth Guide for Smartlead. Seamlessly authenticate email accounts with Google oAuth- Smartlead

Use this guide to connect a Gmail or Google Workspace mailbox using **Smartlead’s Infrastructure**. 

This setup uses Smartlead’s pre-verified Google OAuth app - no Google Cloud project setup is required.

## **Prerequisites (Mandatory for Google Workspace)**

Before connecting your Google Workspace mailbox, ensure the following:

-   You have **Google Workspace Super Admin access** (or admin rights to approve third-party app access and scopes).
    
-   **Pop-ups** are allowed in your browser (the Google OAuth consent screen opens in a pop-up window).
    
-   If your organization restricts third-party apps, confirm that **Smartlead’s app is whitelisted or allowed** before proceeding.
    

For Google Workspace, **admin approval is required** in most organizations due to security policies.

## **Step 1 - Go to Email Accounts**

1.  Log in to your **Smartlead** dashboard.  
    
2.  Go to **Email Accounts** from the left-hand navigation menu.
    

![](https://staticfiles.gleap.io/ghelparticle/Nyng7weXxAP0pBGvRoyJJUWrUJl8PHGqsD7xNjON4Q5LFVvrQx0ohdrJAcuvc3JkvcPpfHCAQqj.png)

3.  Click **Connect Mailbox**.
    

![](https://staticfiles.gleap.io/ghelparticle/ddP8QdBzavEZd2Kf28UieUNTsxmUQVthesGUN2Rwqdt5TSxyERnjRDc54ZrotbBNgbNyERWFE5c.png)

4.  You will see two connection options:  
    
    -   **Private Infrastructure** (you set up your own OAuth credentials)  
        
    -   **Smartlead Infrastructure** (uses Smartlead’s managed OAuth setup)
        

![](https://staticfiles.gleap.io/ghelparticle/K2FE73Sd1nl3j7pE8eA9rCLKNtmCTDKmcr4UoVfn8GWIMgOdSF57xiDip7k7mcHCyfV8pcnBtqy.png)

5.  Select **Smartlead Infrastructure** to connect using Smartlead’s default credentials. This option is ideal for a quick setup with minimal configuration.  
    
6.  Select **Google OAuth** if you are connecting to a Google Workspace mailbox.
    

![](https://staticfiles.gleap.io/ghelparticle/UEsiMUTx6bKGal5xzzwIYeG4DlalMtW8PAofdOLiTASAg327AykD7mMzDIs5bFYLchhv3ETavkG.png)

7.  A pop-up will appear showing the **Client ID** used by Smartlead. **Copy this Client ID** - you will need to paste it into your Google Admin Console to whitelist Smartlead as a trusted app.
    

![](https://staticfiles.gleap.io/ghelparticle/11eFqXgFGTIJgIYgdl0uPEq2hhLiUEsaAay4TtUFQ53b8Q47YmZqbwtWuzbzmBrPdYUN3NEr12C.png)

Once you copy the client ID, click on the Admin Panel link (as shown in the above screenshot). This will take you to the Admin Panel of your Google Workspace.

## **Step 2 - Approve Smartlead in Google Admin Console (Admin Action Required)**

If this is your organization’s first time connecting Smartlead via OAuth, your Google Workspace Admin must approve Smartlead’s app before the connection can proceed.

1.  Go to your **Google Admin Console** at [](https://admin.google.com/)[https://admin.google.com](https://admin.google.com).
    
2.  Navigate to:
    

**Security → Access and Data Control → API Controls → Manage App Access**

![](https://staticfiles.gleap.io/ghelparticle/KeFAo27NrImNj3c3kpH2Qc2QukflTsiDXZlePDKhX43HEk1aYnDYzldP2Uv0XkvREnPv3BqCV0H.png)

On the API Controls screen, select Manage App Access. 

![](https://staticfiles.gleap.io/ghelparticle/TgMaJFESfdWP2iWtlWT8I7hvGWw8iWWxeblmD56D2dyTuLsjqei56nZGTC9CEeItsXMbsklFepw.png)

To add Smartlead as trusted apps, click on **Configure New App** on screen.

![](https://staticfiles.gleap.io/ghelparticle/NlO2Qy0Tv5JLWAAcoOpTzGWlZ6ah2QFqM83KeKEIm4PC5wXBeYmORrb8bnVgHW8Eyi4mWRbLKAw.png)

3.  Paste the **Smartlead Client ID** (copied from the Smartlead pop-up earlier) in the search bar.
    

![](https://staticfiles.gleap.io/ghelparticle/qnP9ngXEteqjQLwJYEcYF3B4hs6EUzEhsVAv9B0OF6bDG1fEPhhO4pl5yioCCRJ1ub9iENTvnDP.png)

You’ll see the **Smartlead app** appear in the results — click on it to proceed.

![](https://staticfiles.gleap.io/ghelparticle/W96QTqL6ZKk1HcvtszLgcVCtD2k0hPYw6pqhJmUAfFqttwnfTP4oKA3g6FUs77VE1E1UZuBbGRm.png)

On the next screen, choose how you want to apply the access:

-   **All users in your organization (same domain)**, or  
    
-   A **specific organizational unit or department**.
    

![](https://staticfiles.gleap.io/ghelparticle/IbZL7PKtxsUWhsANiW7ET6lchC2sXvrNYMhr3GD6x2zBWValVL1yslcmQnicUMMtJR2N2jT1i41.png)

If you want to manage this setting in bulk later, refer to Google’s documentation on [bulk updates for app access settings](https://support.google.com/a/answer/12653991?hl=en-GB&visit_id=638967342633285896-1880210440&p=apps-bulk-upload&rd=1). 

**Note:** Bulk update is only needed if your organization manages multiple domains or organizational units. It allows you to apply the same Smartlead access setting across all of them simultaneously.

Click **Continue** to proceed.

In the following screen, select **Trusted** to mark Smartlead as an approved app. This step ensures that Smartlead’s app is recognized as a trusted application in your Workspace. Once trusted, all users within your domain can connect their accounts seamlessly.

![](https://staticfiles.gleap.io/ghelparticle/dXOdBLzEmrIvT4JQghO7lROOlfxuennd2r9ATl2aQEmbu5Bi6QnNwzsQXpdc7sC6eJUuWHkxny9.png)

Click **Continue**, review the configuration details, and then click **Finish** to complete the setup.

Note: It may take up to 10 minutes for this change to propagate across your Workspace domain.

After the app is approved in your Google Admin Console:

1.  Return to **Smartlead → Email Accounts → Add Account → Shared Infrastructure → Google**.  
    
2.  Click **Connect Account**.  
    
3.  The Google OAuth consent screen will open in a new pop-up window.  
    
    -   If the window doesn’t appear, check your browser settings and allow pop-ups for Smartlead.  
        
4.  Select the Google Workspace account you want to connect to.  
    
5.  Review the requested permissions (Gmail API, send mail, read profile).  
    
6.  Click **Allow** to grant access.  
    
7.  Wait to be redirected back to Smartlead - your mailbox will now appear as **Connected** or **Active**.
    

## **Important: Understanding the “This App Is Blocked” Message**

If you attempt to connect before the Smartlead app is approved in your Workspace, Google will display the following error:

![](https://staticfiles.gleap.io/ghelparticle/Jhj4RfitdKYwjyKkyoIQOe6bImyXGQzbzaX41wM2Qrk0hEEdllUolaxSfW8lEP30O25u222aJGW.png)

This is expected behavior when Smartlead has not yet been added as a trusted third-party app in your organization. If you encounter this, simply add Smartlead as a trusted app by following the steps we discussed above.

### **What This Means**

-   Smartlead app is safe and compliant.  
    
-   Your Workspace Admin simply needs to approve it once.  
    
-   After approval, the message will no longer appear for any user in your domain.
    

### **Retry the Connection**

Once the admin approval is completed:

1.  Return to Smartlead and click **Connect** again.  
    
2.  The consent screen should now appear normally.  
    
3.  Complete the OAuth authorization and confirm the connection.
    

If the blocked message still appears, wait a few minutes and retry - the permission update may take time to propagate.

### **Need Help?**

If you continue to face issues connecting your account after approval, contact our **chat support** with a screenshot of the error.