​
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
1

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.
2

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
3

Add Authentication (if needed)

If your email server requires authentication:
  • SMTP Username (optional) - Username for SMTP authentication
  • SMTP Password (optional) - Password for SMTP authentication
4

Complete Setup

Click “Complete Setup” to save your configuration and proceed with the onboarding process.

Smtp in Onboarding setup

​
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:
ProviderSMTP HostPortSecurity
Gmailsmtp.gmail.com587TLS
Outlook/Office 365smtp.office365.com587TLS
Amazon SESemail-smtp.region.amazonaws.com587TLS
SendGridsmtp.sendgrid.net587TLS

​
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

  1. Verify your SMTP settings are correct
  2. Ensure the “From Email Address” is properly configured
  3. Check if your email provider restricts automated sending
  4. Look for error messages in your application logs
  5. Test your SMTP server connection using external tools