SMTP Setup Guide - Gmail
This guide explains how to configure an SMTP (Simple Mail Transfer Protocol) connection in your Springdel console to enable outgoing emails — including system notifications, password resets, and alert messages.
Key Benefits
- Secure Email Sending – Send system-generated emails through a trusted provider.
- Customizable Identity – Use your own email domain or Gmail account.
- Reliable Delivery – Ensure timely and successful delivery of automated messages.
Step 1 - Enter Connection Details
- Go to your tenant's Settings, then open the SMTP Settings tab.
- Fill in the following fields:
- Connection Name
Give your SMTP connection a clear, recognizable name (for example, Gmail SMTP).
Example: Example SMTP - Server Address
Enter the SMTP server address for your email provider.
Example for Gmail: smtp.example.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.
Important: 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.
Example: yourname@example.com - Password
For Gmail, it is strongly recommended to use an App Password instead of your main Gmail password — especially if you have two-factor authentication (2FA) enabled. - File Size Limit (Optional)
Set a limit for attachment sizes if required.
- Connection Name
Step 2 - Enter Sender Details
- Sender Email:
The email address that will appear in the “From” field for all outgoing messages. - Sender Name:
A clear and professional display name that will appear as the sender in outgoing messages.
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
- Sign in to your Google Account and go to Account Settings > Security.
- Under Signing into Google, select App Passwords.
- You may be asked to verify your identity with your password or 2FA.
- 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.
- Click Generate.
- Google will display a 16-character App Password. Copy this password.
- Use this App Password as your SMTP password in the connection settings.
Important: Do not share this password. If needed, you can revoke it anytime from your Google Account.
Best Practices & Tips
- Use App Passwords for Gmail: Always generate a Google App Password instead of using your main Gmail password, especially if 2FA is enabled.
- Enable SSL or TLS: Use SSL (Port 465) or TLS/STARTTLS (Port 587) to ensure secure email transmission.
- Test Before Going Live: Use the Test Connection function to verify settings before enabling SMTP for production use.
- Limit File Size for Attachments: Configure a file size limit to prevent failed email sends due to oversized attachments.