• Home
• Content Library
• SMTP Gateways
• Configure Google as SMTP Using OAuth 2.0

Configure Google as SMTP Using OAuth 2.0

---

An SMTP Server is an application that allows your device or server to send and receive electronic mails (emails) to and from various recipients. SMTP stands for Simple Mail Transfer Protocol and is a standard protocol used for sending emails.

By default, miniOrange provides and uses its own SMTP server to send OTPs and system emails to users. If you have a custom SMTP server configured, you can use it to send emails from your miniOrange account. miniOrange supports both Basic Authentication and OAuth 2.0–based authentication for Google, allowing you to choose the method that best fits your security requirements. Check out our list of Supported SMTP Servers.

miniOrange IdP allows you to configure Google as an SMTP email provider using either basic configuration or OAuth 2.0, giving you greater control to manage, monitor, and troubleshoot your email communications securely.

Follow the guide below to Configure Google as SMTP Using OAuth 2.0

1. Configure Gmail SMTP OAuth 2.0 in miniOrange

• Login to miniOrange Admin Console.
• Go to Customization >> Custom Email Provider.



• Use Custom gateway and select Google (Oauth 2.0)




Auth_url	https://accounts.google.com/o/oauth2/auth?prompt=consent&access_type=offline
Access token URL	https://oauth2.googleapis.com/token
Host	smtp.gmail.com
Port	587 (STARTTLS)
Encryption Type	TLS
Scope	https://mail.google.com/
Username	<your google admin account username>
Sender Name	miniOrange
Email address	your email address where you want to receive the email.

Copy the below callback URL

• https://<branding>.miniorange.in/services/api/provisioning/app/authorize/custom-provisioning/callback
• This URL is used by Google to redirect users back to your IAM broker after they grant consent.

2. Register Your Application in Google Cloud Console

• Go to https://console.developers.google.com/ and sign up/login.
• Click on Select Project to create a new Google Apps Project, you will see a popup with the list of all your projects.



• You can click on the New project button to create new project.



• Enter your Project name under the Project Name field and click on Create.



• Go to Navigation Menu >> APIs & Services >> Credentials.



• Click on Create Credentials button and then select OAuth Client ID from the options provided.



• Select Web Application from dropdown list to create new application.



• Enter the name you want for your Client ID under the name field and enter the Redirect/Callback URL that we saved in the Step 1 and click on the Create button.



• You will see a popup with the Client ID and Client Secret. Copy your Client ID and Client Secret, and optionally download the JSON file for reference.



• You have successfully completed your Google App OAuth Server side configurations.

Enable Gmail API

• In APIs & Services >> Library, search for Gmail API.



• Click Enable to allow your application to authenticate via OAuth.

3. Test SMTP

• Navigate to Step 1 and fill in the Client ID and Client Secret obtained earlier.
• Fill in the required details and click Save & Authorize.
• Once authorization is successful, enter a test email address and click Test Configuration to verify the SMTP setup.

External References

• Setup Google Workspace as SMTP
• Setup Gmail as SMTP