SMTP
Configure email capabilities for authentication and notifications
SMTP Configuration
Your AI agent application requires SMTP configuration to enable email-based features like One-Time Password (OTP) authentication, password reset, and notifications.
When properly configured, your application can send automated emails to users for:
- One-Time Password (OTP) authentication
- Password reset requests
- Send invitations to the users to your organisation
Configuration Options
Configuring SMTP During Onboarding
At the time of setting up your app for the first time onboarding configuration dialog will open automatically
Access the SMTP Configuration Step
After completing the LLM, Storage, and Connector setup steps in the onboarding process, you will reach the SMTP configuration screen.
Fill in Required Information
Enter the necessary SMTP details:
- SMTP Host (required) - The address of your email server (e.g., smtp.gmail.com)
- Port (required) - The port number for your SMTP server (Default: 587)
- From Email Address (required) - The email address that will appear as the sender
Add Authentication (if needed)
If your email server requires authentication:
- SMTP Username (optional) - Username for SMTP authentication
- SMTP Password (optional) - Password for SMTP authentication
Complete Setup
Click “Complete Setup” to save your configuration and proceed with the onboarding process.
Configuring SMTP During Onboarding
At the time of setting up your app for the first time onboarding configuration dialog will open automatically
Access the SMTP Configuration Step
After completing the LLM, Storage, and Connector setup steps in the onboarding process, you will reach the SMTP configuration screen.
Fill in Required Information
Enter the necessary SMTP details:
- SMTP Host (required) - The address of your email server (e.g., smtp.gmail.com)
- Port (required) - The port number for your SMTP server (Default: 587)
- From Email Address (required) - The email address that will appear as the sender
Add Authentication (if needed)
If your email server requires authentication:
- SMTP Username (optional) - Username for SMTP authentication
- SMTP Password (optional) - Password for SMTP authentication
Complete Setup
Click “Complete Setup” to save your configuration and proceed with the onboarding process.
Configuring SMTP in Settings
If you skipped SMTP configuration during onboarding or need to modify your settings later:
Access Authentication Settings
- Navigate to the sidebar menu
- Select “Settings”
- Click on “Authentication” in the submenu Scroll down to the “Server Configuration” section and find the SMTP configuration option.
Edit SMTP Settings
Click the settings icon next to the SMTP configuration to open the configuration modal.
Update Configuration
Enter or update the required fields:
- SMTP Host (required)
- Port (required, default 587)
- From Email Address (required)
- Username (optional)
- Password (optional)
Click “Save” to apply your new SMTP configuration. If the Smtp box shows configured, then your smtp configuration has been successfully added.
Required vs Optional Fields
Required Fields
- SMTP Host - The address of your email server
- Port - The port number (common: 25, 465, 587)
- From Email Address - Sender email address
Optional Fields
- SMTP Username - For server authentication
- SMTP Password - For server authentication
Common SMTP Providers
The table below lists settings for popular email providers:
| Provider | SMTP Host | Port | Security |
|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | TLS |
| Outlook/Office 365 | smtp.office365.com | 587 | TLS |
| Amazon SES | email-smtp.region.amazonaws.com | 587 | TLS |
| SendGrid | smtp.sendgrid.net | 587 | TLS |
Best Practices
For optimal SMTP configuration:
- Use a dedicated email address for system notifications (e.g., noreply@yourcompany.com)
- Check with your email provider for specific SMTP settings and requirements
- Test your configuration by sending a test email after setup
- Use secure connections when possible (Port 465 for SSL or 587 for TLS)
- Check spam filters if users report not receiving emails
Troubleshooting
- Verify your SMTP settings are correct
- Ensure the “From Email Address” is properly configured
- Check if your email provider restricts automated sending
- Look for error messages in your application logs
- Test your SMTP server connection using external tools