SMTP Setup

Configure SMTP settings to ensure reliable email delivery from Agency OS AI.

Why SMTP?

SMTP (Simple Mail Transfer Protocol) ensures:

  • Emails reach the inbox, not spam
  • Proper sender authentication
  • Delivery tracking and logging
  • Better deliverability rates

SMTP Configuration

Navigate to Agency OS → Settings → SMTP and configure:

Required Settings

Setting Description
SMTP Host Mail server address (e.g., smtp.gmail.com)
SMTP Port Usually 587 (TLS) or 465 (SSL)
Encryption SSL or TLS
Username SMTP authentication username
Password SMTP authentication password

Optional Settings

Setting Description
From Name Default sender name
From Email Default sender email
Reply-To Default reply-to address

Popular SMTP Providers

Gmail / Google Workspace

Host: smtp.gmail.com Port: 587 Encryption: TLS Username: your-email@gmail.com Password: App Password (not regular password)
Note: Gmail requires an App Password. Enable 2FA first, then generate at myaccount.google.com/app-passwords

Microsoft 365 / Outlook

Host: smtp.office365.com Port: 587 Encryption: TLS Username: your-email@company.com Password: your-email-password

Amazon SES

Host: email-smtp.us-east-1.amazonaws.com Port: 587 Encryption: TLS Username: AWS_ACCESS_KEY Password: AWS_SECRET_KEY

Mailgun

Host: smtp.mailgun.org Port: 587 Encryption: TLS Username: postmaster@yourdomain.com Password: your-mailgun-smtp-password

SendGrid

Host: smtp.sendgrid.net Port: 587 Encryption: TLS Username: apikey Password: SG.your-api-key

Testing SMTP

After configuration:

  1. Click Save Settings
  2. Click Send Test Email
  3. Enter a test email address
  4. Check for success or error message

Troubleshooting

Connection Failed

  • Verify host and port are correct
  • Check if firewall blocks outbound SMTP
  • Ensure SSL/TLS settings match server

Authentication Failed

  • Double-check username and password
  • For Gmail, use App Password not regular password
  • Check if SMTP credentials were changed

Emails Going to Spam

  • Configure proper SPF, DKIM, and DMARC records
  • Use a dedicated sending domain
  • Warm up new sending addresses

Related Documentation