Email API Documentation Overview This API enables email delivery via SMTP, using Gmail or other supported providers. It supports both OTP (One-Time Password) emails and bulk email sending with HTML content. Authentication is handled securely using an app password. Authentication For enhanced security, the API requires an app password instead of your actual email account password. Ensure the smtp_password provided is an app password generated from your email provider’s security settings. API Endpoints Send OTP Email Endpoint POST /api/send/otp Request Payload { "subject": "OTP Email Title", "from": "email address", "to": "email address", "smtp_server": "smtp.gmail.com", "smtp_port": "587", "smtp_username": "email address", "smtp_password": "your_app_password", "body": "Your OTP is 12456" } Description Sends a One-Time Password (OTP) email to a specified recipient Uses SMTP for secure email transmission The smtp_password must be an app password, not the actual account password Response Example { "status": "success", "message": "OTP email sent successfully." } Send Bulk Email Endpoint POST /api/send/bulk/mails Request Payload { "subject": "Email Subject", "from": "email address", "to": ["email address", "email address"], "smtp_server": "smtp.gmail.com", "smtp_port": "587", "smtp_username": "email address", "smtp_password": "your_app_password", "body": "encoded_html_content" } Description Sends bulk emails to multiple recipients in a single request Supports rich HTML email content The email body must be properly encoded before sending Encoding HTML Content Before sending HTML emails, the content must be Base64 encoded. Example import base64 html_content = """<!DOCTYPE html> <html> <body>

Welcome to [Your Service]

Start your journey with us today!

Learn More

If you'd like to unsubscribe, click here.

</body> </html>""" encoded_body = base64.b64encode(html_content.encode()).decode() Use encoded_body as the value for the body field in your request. Response Example { "status": "success", "message": "Bulk email sent successfully." } Best Practices Always use an app password for SMTP authentication Ensure HTML content is correctly Base64 encoded Avoid sending too many recipients in a single request to reduce spam risk Common SMTP Servers Gmail SMTP Server: smtp.gmail.com Ports: 587 (TLS), 465 (SSL), 25 Security: TLS / SSL Yahoo Mail SMTP Server: smtp.mail.yahoo.com Ports: 465 (SSL), 587 (TLS) Outlook / Hotmail / Live SMTP Server: smtp.office365.com, smtp-mail.outlook.com Ports: 587 (TLS), 465 (SSL) Microsoft 365 (Exchange Online) SMTP Server: smtp.office365.com Port: 587 (TLS) iCloud Mail SMTP Server: smtp.mail.me.com Ports: 587 (TLS), 465 (SSL) Zoho Mail SMTP Server: smtp.zoho.com Ports: 465 (SSL), 587 (TLS) Yandex Mail SMTP Server: smtp.yandex.com Ports: 465 (SSL), 587 (TLS) AOL Mail SMTP Server: smtp.aol.com Ports: 465 (SSL), 587 (TLS) GMX Mail SMTP Server: mail.gmx.com Ports: 465 (SSL), 587 (TLS) ProtonMail (via Bridge) SMTP Server: 127.0.0.1 Ports: 1025, 1026 (TLS) Mail.com SMTP Server: smtp.mail.com Ports: 465 (SSL), 587 (TLS) FastMail SMTP Server: smtp.fastmail.com Ports: 465 (SSL), 587 (TLS) Postmark SMTP Server: smtp.postmarkapp.com Port: 587 (TLS) SendGrid SMTP Server: smtp.sendgrid.net Port: 587 (TLS) Mandrill SMTP Server: smtp.mandrillapp.com Port: 587 (TLS) Amazon SES SMTP Server: email-smtp.region.amazonaws.com Ports: 587 (TLS), 465 (SSL) Mailgun SMTP Server: smtp.mailgun.org Ports: 465 (SSL), 587 (TLS) Hostinger SMTP Server: smtp.hostinger.com Ports: 465 (SSL), 587 (TLS)