How to Configure Gmail OAuth for Email SMTP

How to Configure Gmail OAuth for Email SMTP

OAuth (Open Authorization) is a protocol that allows users to grant third-party applications limited access to their resources without sharing their passwords. Gmail OAuth is commonly used to authenticate and access Gmail accounts securely. This guide will walk you through the steps to use your Gmail OAuth for authentication in whitelabel tracking software

Prerequisites
Before you start, ensure you have:

  1. An active Google account.
  2. A project set up in the Google Cloud Console.
  3. A whitelabel Tracking Account

Step-by-Step Guide
1. Create a Project in Google Cloud Console

  1. Visit Google Cloud Console: Go to Google Cloud Console.
  2. Create a New Project: Click on the project drop-down at the top and select "New Project." Give your project a name and click "Create."
 

iii. Enable Gmail API: Navigate to "APIs & Services" > "Library." Search for "Gmail API" and click "Manage."





  1. Go to OAuth Consent Screen: Under "APIs & Services," click "OAuth consent screen."
3. Create OAuth Credentials

i. Configure Branding: .  Fill in the required fields such as App name, User support email, Authorized domain(your company domain) and Developer contact information. Follow the prompts and save the changes.




ii. Configure Audience: Publish the App


iii. Configure Clients: Create Client-> Choose the application type (e.g., Web application), provide a name, and specify the authorized redirect URIs. These URIs are where users will be redirected after authentication.



iv. Configure OAuth Client: Choose the application type (e.g., Web application), provide a name, and specify the authorized redirect URIs. These URIs are where users will be redirected after authentication.



v. Get Client ID and Client Secret: After creating, you'll receive a Client ID and Client Secret. Note these down as you'll need them for the SMTP Settings setup on the application



4.  Save your Client ID and Client secret on the EMAIL SMTP SETTINGS on your WLT account 
  1. Grant Access by connecting to your account: You will be prompted to grant access to your Gmail account.
  2. Access Gmail Data: Once authenticated, the application will be able to access Gmail data based on the scopes you defined.
  3. Run a test by sending a TEST EMAIL


CONCLUSION
Google frequently updates these features—both in terms of UI and security enhancements. If you encounter any issues or need additional assistance, please refer to the Google API Documentation or contact the Google support team.