SMTP Setup Guide - Gmail

This guide explains how to configure your SMTP (Simple Mail Transfer Protocol) connection in your console to enable outgoing emails, such as notifications, password resets, or system alerts.

Why Use SMTP?

• Send system-generated emails securely
• Use your own email domain or trusted provider
• Ensure reliable delivery of automated messages

Step 1: Enter Connection Details

1. Go to your tenant Settings
2. Click on SMTP Settings tab
3. Fill in your connection details

Connection Name
Give your SMTP connection a clear, recognizable name (for example, Gmail SMTP).

Server Address
Enter the SMTP server address for your email provider.
Example for Gmail: smtp.gmail.com

Port
Specify the port number.
Typical ports: 465 (SSL) or 587 (TLS/STARTTLS).

Use SSL
Enable this toggle if your SMTP provider requires SSL for secure email sending.
For Gmail, SSL is recommended.

Authentication Type
Select your authentication method — usually Basic for most SMTP providers.

Username
Enter the full email address you want to send emails from (for example, yourname@gmail.com).

Password
For Gmail, it is strongly recommended to use an App Password instead of your main account password, especially if you have two-factor authentication (2FA) enabled.

File Size Limit (Optional)
Set a limit for attachment sizes if required.

Step 2: Enter Sender Details

Sender Email
This is the email address that will appear in the “From” field for all outgoing emails.

Sender Name
Enter a clear display name that recipients will recognize (for example, Your Company Support).

Step 3: Test the Connection

Once all fields are complete:

• Click Test Connection to verify that your SMTP settings are working properly.
• If the test is successful, click Save to store your configuration.
  
  

How to Generate a Google App Password

1. Sign in to your Google Account and go to Account Settings > Security.
2. Under Signing into Google, select App Passwords.
3. You may be asked to verify your identity with your password or 2FA.
4. Under Select the app and device, choose Mail for the app and Other (Custom name) for the device — give it a name like SMTP Connection.
5. Click Generate.
6. Google will display a 16-character App Password. Copy this password.
7. Use this App Password as your SMTP password in the connection settings.