Python Notes
HubHistory of Python - Complete Guide 2026Python Applications - Complete Guide 2026Python Features - Complete Guide 2026What is Python? - Complete Guide 2026Why Learn Python? - Complete Guide 2026Your First Python Program – Hello World & Beyond 2026How to Install Python on Windows, Mac & Linux – Complete Guide 2026Install VS Code for Python – Complete Setup Guide with Extensions 2026Python Environment Setup – Virtual Environments, pip & Project Structure 2026Python IDLE – Complete Guide for Beginners 2026Python CommentsPython Data TypesPython Input and OutputPython OperatorsPython SyntaxPython Strings BasicsPython Type CastingPython VariablesBreak, Continue and Pass in PythonElif Statement in PythonFor Loop in PythonIf-Else Statement in PythonIf Statement in PythonNested If in PythonPattern Programs in PythonWhile Loop in PythonDecorators in PythonFunction Arguments in PythonFunctions Basics in PythonGenerators in PythonLambda Functions in PythonRecursive Functions in PythonReturn Statement in PythonScope of Variables in PythonAbstraction in PythonClasses and Objects in PythonConstructors in PythonEncapsulation in PythonInheritance in PythonMagic Methods (Dunder Methods) in PythonMethod Overriding in PythonPolymorphism in PythonPython Comprehensions – List, Dict, Set & GeneratorPython Dictionaries – Key-Value StorePython Dictionary Methods – Complete ReferencePython List Methods – All Built-in MethodsPython Lists – Complete GuidePython Set Methods – Complete ReferencePython Sets – Unordered Unique CollectionsPython Tuples – Immutable SequencesPython Asynchronous Programming with asyncioPython Context ManagersAdvanced Python DecoratorsAdvanced Python GeneratorsPython Iterators - Advanced GuidePython Memory ManagementPython MultiprocessingPython MultithreadingCRUD Operations in Python DatabasesMySQL with Python (mysql-connector-python)ORM Introduction with SQLAlchemyPostgreSQL with Python (psycopg2)SQLite3 with PythonIntroduction to DjangoDjango Models and ORMDjango REST API with DRFDjango ViewsIntroduction to FlaskFlask RoutingFlask Templates with Jinja2Email Automation with PythonPDF Automation with PythonSelenium Web Automation with PythonTask Scheduler with PythonWeb Scraping with PythonData Analysis with PythonData Cleaning with PythonData Visualization ProjectData Visualization with MatplotlibNumPy IntroductionPandas IntroductionStatistical Visualization with SeabornClassification AlgorithmsClustering AlgorithmsIntroduction to Machine LearningMachine Learning Project: Churn PredictionModel Evaluation and SelectionRegression AlgorithmsSave pipeline (includes preprocessing + model)AI Assistant ProjectCalculator ProjectChatbot ProjectExpense Tracker ProjectFace Detection ProjectPassword Generator ProjectWeather App ProjectPython Coding Interview QuestionsPython OOP Interview Questions and AnswersPython Master CheatsheetPython Interview Questions and AnswersPython Best PracticesCommon Python Errors and SolutionsPython Debugging TechniquesPython Learning Resources
Complete guide to email automation with Python using smtplib, email library, sending HTML emails, attachments, reading emails with IMAP, and scheduling email automation.
Introduction
You can automatically send and read emails using Python. smtplib (sending) and imaplib (reading) are part of the Standard Library — no extra installation required!
2. Simple Text Email
Example
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
import os
def send_text_email(sender, password, recipient, subject, body):
"""Simple plain text email send karo"""
message = MIMEMultipart("alternative")
message["Subject"] = subject
message["From"] = sender
message["To"] = recipient
# Plain text part
text_part = MIMEText(body, "plain")
message.attach(text_part)
with smtplib.SMTP("smtp.gmail.com", 587) as server:
server.starttls()
server.login(sender, password)
server.send_message(message)
print(f"Email sent to {recipient}")
# Usage (use environment variables for credentials!)
SENDER = os.getenv("EMAIL_SENDER", "your@gmail.com")
PASSWORD = os.getenv("EMAIL_PASSWORD", "your_app_password")
# send_text_email(
# SENDER, PASSWORD,
# "recipient@example.com",
# "Python Automation Test",
# "Hello! This email was sent by Python automation.\n\nWoHoTech Python Course"
# )
# Multiple recipients
def send_to_multiple(sender, password, recipients: list, subject, body):
"""Multiple recipients ko email"""
message = MIMEMultipart()
message["Subject"] = subject
message["From"] = sender
message["To"] = ", ".join(recipients) # TO field
message.attach(MIMEText(body, "plain"))
with smtplib.SMTP("smtp.gmail.com", 587) as server:
server.starttls()
server.login(sender, password)
server.sendmail(sender, recipients, message.as_string())
print(f"Email sent to {len(recipients)} recipients")
3. HTML Email
Example
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
import smtplib
def send_html_email(sender, password, recipient, subject, html_content, plain_text=None):
"""HTML formatted email send karo"""
message = MIMEMultipart("alternative")
message["Subject"] = subject
message["From"] = sender
message["To"] = recipient
# Plain text fallback
if plain_text:
text_part = MIMEText(plain_text, "plain")
message.attach(text_part)
# HTML content
html_part = MIMEText(html_content, "html")
message.attach(html_part) # HTML last add karo — preferred by email clients
with smtplib.SMTP("smtp.gmail.com", 587) as server:
server.starttls()
server.login(sender, password)
server.send_message(message)
# HTML email template
def create_report_email(name, score, grade, course):
"""Student report card email HTML"""
html = f"""
<!DOCTYPE html>
<html>
<body style="font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px;">
<div style="background: linear-gradient(135deg, #667eea 0%, #764ba2 100%); padding: 30px; border-radius: 10px; text-align: center;">
<h1 style="color: white; margin: 0;">🎓 WoHoTech Python Course</h1>
<p style="color: #e0d7ff;">Student Report Card</p>
</div>
<div style="background: #f8f9fa; padding: 30px; margin: 20px 0; border-radius: 10px;">
<h2 style="color: #333;">Dear {name},</h2>
<p>Aapke Python Master Course results ready hain!</p>
<table style="width: 100%; border-collapse: collapse; margin: 20px 0;">
<tr style="background: #667eea; color: white;">
<th style="padding: 12px; text-align: left;">Course</th>
<th style="padding: 12px; text-align: center;">Score</th>
<th style="padding: 12px; text-align: center;">Grade</th>
</tr>
<tr style="border-bottom: 1px solid #ddd;">
<td style="padding: 12px;">{course}</td>
<td style="padding: 12px; text-align: center; font-weight: bold;">{score}%</td>
<td style="padding: 12px; text-align: center;">
<span style="background: {'#28a745' if grade == 'A' else '#ffc107'};
color: white; padding: 4px 12px; border-radius: 20px;">
{grade}
</span>
</td>
</tr>
</table>
</div>
<div style="text-align: center; padding: 20px;">
<a href="https://wohotech.in"
style="background: #667eea; color: white; padding: 12px 30px;
border-radius: 5px; text-decoration: none; font-weight: bold;">
View Full Report
</a>
</div>
<p style="color: #666; font-size: 12px; text-align: center; margin-top: 30px;">
WoHoTech | Python Master Course | 2026
</p>
</body>
</html>
"""
plain = f"Dear {name}, Your {course} score: {score}% — Grade: {grade}"
return html, plain
html, plain = create_report_email("Alice Johnson", 95.5, "A", "Python Master Course")
print("HTML email template created!")
print(f"Template length: {len(html)} chars")
4. Email with Attachments
Example
import smtplib
import os
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
from email.mime.base import MIMEBase
from email.mime.image import MIMEImage
from email import encoders
import mimetypes
def send_email_with_attachment(sender, password, recipient, subject, body, attachments=None):
"""Send email with attachments"""
message = MIMEMultipart()
message["Subject"] = subject
message["From"] = sender
message["To"] = recipient
# Body text
message.attach(MIMEText(body, "html"))
# Attachments
if attachments:
for filepath in attachments:
if not os.path.exists(filepath):
print(f"File not found: {filepath}")
continue
filename = os.path.basename(filepath)
mime_type, _ = mimetypes.guess_type(filepath)
with open(filepath, "rb") as f:
# Image attachments
if mime_type and mime_type.startswith("image/"):
part = MIMEImage(f.read(), name=filename)
else:
# Generic binary attachment
part = MIMEBase("application", "octet-stream")
part.set_payload(f.read())
encoders.encode_base64(part)
part.add_header("Content-Disposition", f"attachment; filename={filename}")
message.attach(part)
print(f"Attached: {filename}")
with smtplib.SMTP("smtp.gmail.com", 587) as server:
server.starttls()
server.login(sender, password)
server.send_message(message)
print(f"Email with {len(attachments or [])} attachments sent!")
# CC and BCC
def send_with_cc_bcc(sender, password, to, cc=None, bcc=None, subject="", body=""):
"""Email with CC and BCC"""
message = MIMEMultipart()
message["Subject"] = subject
message["From"] = sender
message["To"] = to
if cc:
message["Cc"] = ", ".join(cc)
# Don't put BCC in header — just add to recipients list
all_recipients = [to]
if cc: all_recipients.extend(cc)
if bcc: all_recipients.extend(bcc)
message.attach(MIMEText(body, "plain"))
with smtplib.SMTP("smtp.gmail.com", 587) as server:
server.starttls()
server.login(sender, password)
server.sendmail(sender, all_recipients, message.as_string())
📝 Hindi Explanation
MIMEBase is for generic file attachments. encoders.encode_base64() converts binary data to email-safe base64 format. BCC (Blind Carbon Copy) should not be placed in the header — only add it to the recipients list. Otherwise, other recipients will see the BCC addresses.5. Reading Emails with IMAP
Example
import imaplib
import email
from email.header import decode_header
def read_emails(username, password, provider="gmail", folder="INBOX", limit=10):
"""IMAP se emails padhna"""
imap_servers = {
"gmail": "imap.gmail.com",
"outlook": "imap-mail.outlook.com",
"yahoo": "imap.mail.yahoo.com",
}
server = imaplib.IMAP4_SSL(imap_servers[provider])
try:
server.login(username, password)
print("IMAP connected!")
# Folder select karo
server.select(folder)
# Search emails
_, message_ids = server.search(None, "ALL")
email_ids = message_ids[0].split()[-limit:] # Last 'limit' emails
emails = []
for email_id in reversed(email_ids):
_, msg_data = server.fetch(email_id, "(RFC822)")
raw_email = msg_data[0][1]
msg = email.message_from_bytes(raw_email)
# Decode subject
subject, encoding = decode_header(msg["Subject"])[0]
if isinstance(subject, bytes):
subject = subject.decode(encoding or "utf-8", errors="replace")
# Decode from
sender = msg.get("From", "")
# Get body
body = ""
if msg.is_multipart():
for part in msg.walk():
if part.get_content_type() == "text/plain":
payload = part.get_payload(decode=True)
if payload:
body = payload.decode(errors="replace")
break
else:
payload = msg.get_payload(decode=True)
if payload:
body = payload.decode(errors="replace")
emails.append({
"id": email_id.decode(),
"subject": subject,
"from": sender,
"date": msg.get("Date"),
"body": body[:500],
})
return emails
finally:
server.logout()
# emails = read_emails("your@gmail.com", "app_password")
# for email in emails:
# print(f"From: {email['from']}")
# print(f"Subject: {email['subject']}")
# print("---")
6. Email Filtering and Search
Example
import imaplib
import email
def search_emails(server, criteria):
"""Advanced email search"""
# IMAP search criteria examples:
# "ALL" — all emails
# "UNSEEN" — unread emails
# "FROM alice@example.com" — from specific sender
# "SUBJECT Python" — subject contains 'Python'
# "SINCE 01-Jan-2026" — emails since date
# "BEFORE 01-Jun-2026" — emails before date
# "BODY report" — body contains 'report'
_, message_ids = server.search(None, criteria)
return message_ids[0].split()
def filter_emails_by_sender(username, password, target_sender):
"""Specific sender ke emails dhundho"""
server = imaplib.IMAP4_SSL("imap.gmail.com")
server.login(username, password)
server.select("INBOX")
search_query = f"FROM {target_sender}"
ids = search_emails(server, search_query)
print(f"Found {len(ids)} emails from {target_sender}")
server.logout()
return ids
def mark_as_read(server, email_id):
"""Mark email as read"""
server.store(email_id, "+FLAGS", "\\Seen")
def delete_email(server, email_id):
"""Email delete karo"""
server.store(email_id, "+FLAGS", "\\Deleted")
server.expunge()
def move_to_folder(server, email_id, destination_folder):
"""Move email to folder"""
server.copy(email_id, destination_folder)
server.store(email_id, "+FLAGS", "\\Deleted")
server.expunge()
7. Email Automation Examples
Example
import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
import os
from datetime import datetime
class EmailAutomation:
"""Automated email sending class"""
def __init__(self, sender_email, app_password):
self.sender = sender_email
self.password = app_password
def _create_server(self):
server = smtplib.SMTP("smtp.gmail.com", 587)
server.starttls()
server.login(self.sender, self.password)
return server
def send_bulk_emails(self, recipients: list, subject: str, body_template: str):
"""Template se bulk personalized emails"""
with self._create_server() as server:
success = 0
for recipient in recipients:
try:
# Personalize karo
body = body_template.format(**recipient)
msg = MIMEMultipart("alternative")
msg["Subject"] = subject.format(**recipient)
msg["From"] = self.sender
msg["To"] = recipient["email"]
msg.attach(MIMEText(body, "html"))
server.send_message(msg)
success += 1
print(f" ✓ Sent to {recipient['email']}")
except Exception as e:
print(f" ✗ Failed for {recipient.get('email', '?')}: {e}")
print(f"\n{success}/{len(recipients)} emails sent!")
# Usage example
automation = EmailAutomation("your@gmail.com", "app_password")
template = """
<h2>Dear {name},</h2>
<p>Your Python course update for <strong>{date}</strong>:</p>
<p>Current progress: <strong>{progress}%</strong></p>
<p>Keep learning! 🚀</p>
"""
students = [
{"name": "Alice", "email": "alice@example.com", "progress": 75, "date": "June 2026"},
{"name": "Bob", "email": "bob@example.com", "progress": 60, "date": "June 2026"},
]
# automation.send_bulk_emails(students, "Python Course Update — {name}", template)
# Daily report email
def send_daily_report(email_obj, recipients, report_data):
"""Daily automated report"""
date_str = datetime.now().strftime("%B %d, %Y")
subject = f"Daily Python Course Report — {date_str}"
html = f"""
<h1>Daily Report — {date_str}</h1>
<table border="1" cellpadding="8" style="border-collapse:collapse">
<tr><th>Metric</th><th>Value</th></tr>
<tr><td>Total Students</td><td>{report_data.get('total_students', 0)}</td></tr>
<tr><td>Active Today</td><td>{report_data.get('active_today', 0)}</td></tr>
<tr><td>Avg Score</td><td>{report_data.get('avg_score', 0):.1f}%</td></tr>
</table>
"""
for recipient in recipients:
email_obj.send_bulk_emails(
[{"email": recipient, "name": "Admin"}],
subject,
html
)
8. Best Practices
Example
import os
# ✅ Use environment variables for credentials
SENDER_EMAIL = os.getenv("EMAIL_SENDER")
APP_PASSWORD = os.getenv("EMAIL_APP_PASSWORD")
# ✅ Use Gmail App Passwords (not your actual Gmail password)
# Go to: Google Account > Security > 2FA > App Passwords
# ✅ Use SSL/TLS (port 587 with STARTTLS or 465 with SSL)
import smtplib, ssl
# STARTTLS (port 587)
with smtplib.SMTP("smtp.gmail.com", 587) as server:
server.starttls()
# ...
# SSL (port 465)
context = ssl.create_default_context()
with smtplib.SMTP_SSL("smtp.gmail.com", 465, context=context) as server:
pass # ...
# ✅ Add retry logic
import time
def send_with_retry(send_func, max_retries=3):
for attempt in range(max_retries):
try:
return send_func()
except smtplib.SMTPException as e:
if attempt < max_retries - 1:
time.sleep(2 ** attempt) # Exponential backoff
else:
raise
# ❌ Don't hardcode credentials
# password = "my_secret_password" # BAD!
# ✅ Validate email addresses
import re
def is_valid_email(email):
pattern = r'^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$'
return bool(re.match(pattern, email))
print(is_valid_email("alice@gmail.com")) # True
print(is_valid_email("not-an-email")) # False
Summary
| Library | Purpose |
|---|---|
smtplib | Send emails via SMTP |
imaplib | Read emails via IMAP |
MIMEText | Plain text / HTML content |
MIMEMultipart | Email with multiple parts |
MIMEBase | File attachments |
MIMEImage | Image attachments |
email.header | Decode email headers |
Example
# Quick email send template
import smtplib
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
def quick_send(to, subject, html_body):
sender = "your@gmail.com"
password = "app_password" # Use env var in production!
msg = MIMEMultipart("alternative")
msg["From"] = sender
msg["To"] = to
msg["Subject"] = subject
msg.attach(MIMEText(html_body, "html"))
with smtplib.SMTP("smtp.gmail.com", 587) as s:
s.starttls()
s.login(sender, password)
s.send_message(msg)
Pro Tip: For production email automation, consider using dedicated services like SendGrid, Mailgun, or AWS SES — they offer better deliverability, analytics, and don't have Gmail's daily sending limits.
📤 Output Examples
SMTP Connection Output
python example
# From Section 1 - create_smtp_connection()
server = create_smtp_connection("your@gmail.com", "app_password", "gmail")Output
Connected to smtp.gmail.com:587
Text Email Output
python example
# From Section 2 - send_text_email()
send_text_email(SENDER, PASSWORD, "recipient@example.com", "Python Test", "Hello!")Output
Email sent to recipient@example.com
Multiple Recipients Output
Example
# From Section 2 - send_to_multiple()
send_to_multiple(SENDER, PASSWORD, ["a@test.com", "b@test.com"], "Hello", "Test body")
Output
Email sent to 2 recipients
HTML Template Output
python example
# From Section 3 - create_report_email()
html, plain = create_report_email("Alice Johnson", 95.5, "A", "Python Master Course")
print("HTML email template created!")
print(f"Template length: {len(html)} chars")Output
HTML email template created! Template length: 1847 chars
Attachment Email Output
Example
# From Section 4 - send_email_with_attachment()
send_email_with_attachment(
SENDER, PASSWORD, "recipient@example.com",
"Report Attached", "<p>Please find report attached.</p>",
attachments=["report.pdf", "data.csv"]
)
Output
Attached: report.pdf Attached: data.csv Email with 2 attachments sent!
IMAP Read Emails Output
Example
# From Section 5 - read_emails()
emails = read_emails("your@gmail.com", "app_password")
for e in emails[:3]:
print(f"From: {e['from']}")
print(f"Subject: {e['subject']}")
print("---")
Output
IMAP connected! From: WoHoTech <admin@wohotech.com> Subject: Python Course Update - June 2026 --- From: GitHub <noreply@github.com> Subject: [python-project] New pull request #42 --- From: Alice <alice@example.com> Subject: Re: Project Meeting Notes ---
Email Filter Output
python example
# From Section 6 - filter_emails_by_sender()
ids = filter_emails_by_sender("your@gmail.com", "app_password", "admin@wohotech.com")Output
Found 15 emails from admin@wohotech.com
Bulk Email Output
python example
# From Section 7 - send_bulk_emails()
automation.send_bulk_emails(students, "Python Course Update — {name}", template)Output
✓ Sent to alice@example.com ✓ Sent to bob@example.com 2/2 emails sent!
Email Validation Output
python example
# From Section 8 - is_valid_email()
print(is_valid_email("alice@gmail.com"))
print(is_valid_email("not-an-email"))Output
True False
⚠️ Common Mistakes
❌ Mistake 1: Hardcoding Credentials in Code
python example
# ❌ WRONG — Never do this!
password = "my_secret_password123"
# ✅ CORRECT — Environment variables use karo
import os
password = os.getenv("EMAIL_APP_PASSWORD")Explanation: Hardcoding passwords directly in code is a security risk. If the code is pushed to GitHub, your account can be compromised. Always use environment variables or secret managers.
❌ Mistake 2: Using Gmail's Real Password
python example
# ❌ WRONG — Gmail ka actual password
server.login("you@gmail.com", "gmail_ka_password")
# ✅ CORRECT — App Password use karo (16-character generated password)
server.login("you@gmail.com", "abcd efgh ijkl mnop")Explanation: Gmail rejects normal passwords when 2FA is enabled. Generate one from Google Account → Security → App Passwords. This 16-character password is specifically for third-party apps.
❌ Mistake 3: Putting BCC in the Header
Example
# ❌ WRONG — BCC visible ho jayega sabko!
message["Bcc"] = "secret@example.com"
# ✅ CORRECT — Only add to recipients list, not in header
all_recipients = [to_addr] + bcc_list
server.sendmail(sender, all_recipients, message.as_string())
Explanation: The purpose of BCC is to hide recipients from each other. If you add it to the header, the purpose is defeated — everyone will see the BCC addresses.
❌ Mistake 4: Connection Close Na Karna
python example
# ❌ WRONG — Connection open reh jayegi
server = smtplib.SMTP("smtp.gmail.com", 587)
server.starttls()
server.login(email, password)
server.send_message(msg)
# server.quit() bhool gaye!
# ✅ CORRECT — Context manager use karo
with smtplib.SMTP("smtp.gmail.com", 587) as server:
server.starttls()
server.login(email, password)
server.send_message(msg)
# Automatically close hoga!Explanation: Using the with statement (context manager) is best practice. It ensures the connection is properly closed — even if an error occurs. Without it, connections can remain open and cause resource leaks.❌ Mistake 5: Error Handling Skip Karna
python example
# ❌ WRONG — Koi error handling nahi
server.send_message(msg)
# ✅ CORRECT — Proper try/except
try:
server.send_message(msg)
print("Email sent successfully!")
except smtplib.SMTPRecipientsRefused as e:
print(f"Invalid recipient: {e}")
except smtplib.SMTPException as e:
print(f"SMTP error: {e}")Explanation: Errors are common in network operations — invalid address, server down, rate limit exceeded. Without error handling, your program will crash on the first failure. Always use try/except with specific exception types.
❌ Mistake 6: Ignoring Rate Limiting in Bulk Emails
python example
# ❌ WRONG — Gmail daily limit exceed ho jayegi
for user in 10000_users:
send_email(user) # Gmail limit: ~500/day (free accounts)
# ✅ CORRECT — Be mindful of delays and limits
import time
for i, user in enumerate(users):
if i > 0 and i % 50 == 0:
time.sleep(60) # Wait 1 minute after 50 emails
send_email(user)Explanation: Gmail free accounts have a ~500 emails/day limit and Google Workspace has ~2000/day. Exceeding the limit can temporarily block your account (24 hours). Always add delays between batches.
❌ Mistake 7: Email Body mein Plain Text Fallback Na Dena
python example
# ❌ WRONG — Only HTML, no fallback
msg = MIMEMultipart("alternative")
msg.attach(MIMEText(html_content, "html"))
# ✅ CORRECT — Plain text + HTML dono add karo
msg = MIMEMultipart("alternative")
msg.attach(MIMEText(plain_text, "plain")) # Pehle plain text
msg.attach(MIMEText(html_content, "html")) # Phir HTML (preferred)Explanation: Some email clients (especially older ones or text-only mode) don't render HTML. Providing a plain text fallback ensures your message is always readable.
✅ Key Takeaways
- 📧 smtplib is for sending emails (SMTP protocol), imaplib is for reading emails (IMAP protocol) — both are built into the Python Standard Library
- 🔐 Always use App Password (16-character) with Gmail — normal passwords won't work on 2FA-enabled accounts
- 🔒 TLS/SSL encryption is mandatory — use
STARTTLS(port 587) orSMTP_SSL(port 465), never a plain text connection - 📎 MIME classes define email structure —
MIMEMultipart(container),MIMEText(text/html),MIMEBase(attachments),MIMEImage(images) - 📝 Always include a plain text fallback in HTML emails — use
MIMEMultipart("alternative")and attach plain text first - 👁️ Never put BCC in the email header — only add it to the
sendmail()recipients list, otherwise it becomes visible to all - 🔄 Use a context manager (
withstatement) for SMTP connections — ensures automatic cleanup even if an error occurs - ⏱️ Pay attention to rate limiting in bulk emails — Gmail: ~500/day (free), ~2000/day (Workspace). Add delays between batches
- 🌍 For production email automation, consider SendGrid, Mailgun, or AWS SES — better deliverability, analytics, and higher limits
- 🛡️ Always store credentials in environment variables or secret managers — hardcoding in code is the biggest security anti-pattern
❓ FAQ
Q1: Why isn't my Python script sending email via Gmail? Getting "Authentication failed" error?
Answer: Gmail doesn't accept normal passwords for third-party apps when 2FA (2-Step Verification) is enabled. You need to generate an App Password: Google Account → Security → 2-Step Verification → App Passwords.
Q2: What is the difference between smtplib.SMTP and smtplib.SMTP_SSL?
Answer: SMTP("smtp.gmail.com", 587) first creates a plain connection then encrypts it by calling starttls() (STARTTLS upgrade). SMTP_SSL("smtp.gmail.com", 465) starts with an encrypted connection from the beginning. Both are secure; use port 587 for STARTTLS or port 465 for direct SSL.
Q3: How many emails can you send at once via Gmail?
Answer: Gmail free account: ~500 emails/day. Google Workspace: ~2000 emails/day. If you exceed the limit, your account may be temporarily blocked (24 hours). For high-volume sending, use services like SendGrid or AWS SES.
Q4: How do you add inline images in an email (displayed in the body, not as attachments)?
Answer: Use MIMEImage with a Content-ID header, then reference it with cid: in the HTML:
python example
from email.mime.image import MIMEImage
# Image attach karo with Content-ID
with open("logo.png", "rb") as f:
img = MIMEImage(f.read())
img.add_header("Content-ID", "<logo>")
img.add_header("Content-Disposition", "inline")
message.attach(img)
# Reference in HTML
html = '<img src="cid:logo" alt="Logo">'This technique is widely used in email signatures and newsletters! 🖼️
Q5: Getting encoding errors when reading emails via IMAP — how to fix?
Answer: Emails can have multiple encodings (UTF-8, ISO-8859-1, etc.). Always use errors="replace" or errors="ignore" when decoding:
python example
# Safe decoding
body = payload.decode(encoding or "utf-8", errors="replace")
subject = subject.decode(encoding or "utf-8", errors="replace")The decode_header() function provides encoding info — check first whether it's bytes or already a string. Use defensive coding to avoid Unicode errors.
Q6: Can you send Outlook/Yahoo emails using Python?
Answer: Yes! Just change the SMTP server and port:
- Outlook:
smtp.office365.com, port 587 (STARTTLS) - Yahoo:
smtp.mail.yahoo.com, port 587 (STARTTLS) - iCloud:
smtp.mail.me.com, port 587 (STARTTLS)
The code remains almost the same — only the host/port configuration changes. You may need to generate an app-specific password for each provider. 📬
Q7: How do you schedule an email automation script (daily/weekly automatic)?
Answer: Multiple options hain:
schedulelibrary (Python): Simple in-process schedulingcron(Linux/Mac):0 9 * * * python3 /path/to/email_script.py(daily 9 AM)- Task Scheduler (Windows): GUI based scheduling
- Cloud: AWS Lambda + CloudWatch Events, GitHub Actions (cron syntax)
Cloud-based solutions are better for production since they continue running even when the local machine is off. ⏰
Q8: How do you confirm email delivery after sending?
Answer: The SMTP protocol doesn't provide guaranteed delivery confirmation. Options include:
- Read receipts:
message["Disposition-Notification-To"] = sender(recipient decline kar sakta hai) - Delivery Status Notification:
message["Return-Receipt-To"] = sender - SendGrid/Mailgun webhooks: Track events (delivered, opened, clicked)
- Tracking pixel: Embed a tiny image in the HTML email that hits your server
For production, third-party services (SendGrid, Mailgun) are the best option for delivery tracking. 📩
🎯 Interview Questions
Q1: Which libraries are used for sending emails in Python? Explain the role of SMTP and MIME.
Answer: For sending emails in Python, primarily smtplib (SMTP connection and sending) and the email package (message construction) are used. SMTP handles the connection and delivery protocol. MIME (Multipurpose Internet Mail Extensions) defines the email structure — headers, text, HTML, attachments.
Q2: What is the difference between MIMEMultipart("alternative") and MIMEMultipart("mixed")?
Answer: "alternative" subtype means different representations of the same content (plain text + HTML) — the email client chooses the best format. "mixed" subtype means different types of content together (text + attachments) — all parts are displayed/downloaded.
Q3: What is the difference between TLS and SSL in the email context? Explain Port 587 vs 465.
Answer: Port 587 (STARTTLS): First a plain text connection is established, then the STARTTLS command upgrades it to an encrypted connection. Port 465 (Implicit SSL): The connection is encrypted from the start. Modern recommendation: use port 587 with STARTTLS.
Q4: How would you handle rate limiting in bulk email automation? Describe a production-ready approach.
Answer: A production-ready approach requires multiple layers:
- Delay between sends:
time.sleep(1-2)per email ya batch delays - Queue system: Push emails to a Redis/RabbitMQ queue, let worker processes handle sending
- Exponential backoff: Double the wait time on rate limit errors (2s → 4s → 8s)
- Track daily limits: Maintain a counter, pause when nearing the limit
- Dedicated service: Use SendGrid/AWS SES which provide built-in rate management
- Connection reuse: Don't create a new connection per email — send multiple emails over one connection
- Error categorization: Handle permanent failures (invalid email) vs temporary ones (server busy) differently
Q5: What is the common security mistake in BCC implementation? Describe the correct approach.
Answer: Common mistake: Putting BCC addresses in the message["Bcc"] header. This is a security vulnerability because some mail servers forward headers as-is, exposing BCC addresses. Correct approach: Only add BCC addresses to the sendmail() recipients list, never to the message header.
Q6: What is the difference between IMAP and POP3? Which is better for email reading?
Answer: IMAP (Internet Message Access Protocol): Emails stay on the server, sync across multiple devices, supports folders, and allows selective download. POP3 (Post Office Protocol): Downloads emails and typically deletes from server, single device, no folder sync. IMAP is better for modern multi-device usage.
Q7: What should the error handling strategy be in email automation? Explain different exceptions.
Answer: Key exceptions aur handling:
SMTPAuthenticationError: Wrong credentials → Notify the user, check App PasswordSMTPRecipientsRefused: Invalid recipient → Log it, skip it, don't retrySMTPSenderRefused: Sender blocked → Account status check karoSMTPConnectError: Server unreachable → Retry with backoffSMTPServerDisconnected: Connection dropped mid-send → Reconnect karoSMTPDataError: Message rejected (too large, etc.) → Message fix karosocket.timeout: Network slow → Timeout increase karo ya retry
Best practice: Catch specific exceptions first, generic SMTPException last. Put failed emails in a separate queue for retry. Log permanent failures and alert.
Q8: What are the CSS limitations in email HTML? What are the best practices for email template design?
Answer: Email HTML is very different from web HTML:
- No external CSS:
<link>tags don't work — use inline styles - No JavaScript: Script execution blocked hai
- Limited CSS:
float,position,flexbox,gridunreliable hain - Tables for layout:
<table>based layout most compatible hai - Inline styles only: Some clients remove
<style>blocks (especially Gmail) - Images blocked by default: Alt text important hai
- Max width ~600px: For mobile compatibility
Best practices: Use tables for layout, apply inline CSS, provide alt text for images, include a plain text fallback, and test across multiple email clients.
Q9: What is the maximum attachment size for emails in Python? How do you handle large files?
Answer: Technical limits:
- Gmail: 25 MB per email (attachments included)
- Outlook: 20 MB default
- SMTP servers: Generally 10-25 MB
- Base64 encoding: File size increases ~33% after encoding
For large files, use alternatives:
- Share a cloud link: Include Google Drive/S3 link in email
- File compression: ZIP karo before attaching
- Split attachments: Divide across multiple emails
- Dedicated file transfer: WeTransfer/Dropbox type service use karo
Check file size in code before sending: if os.path.getsize(file) > 20_000_000: use_cloud_link()
Q10: Gmail API vs smtplib — when should you use which? Describe pros/cons.
Answer: smtplib (SMTP):
- ✅ Simple, no setup, Standard Library
- ✅ Works with any email provider
- ❌ Limited features (no labels, no thread management)
- ❌ Rate limits strict, no delivery tracking
- 🎯 Best for: Simple scripts, quick automation, learning
Gmail API (OAuth2):
- ✅ Full Gmail features (labels, threads, search, drafts)
- ✅ Better rate limits, OAuth2 security
- ✅ Read receipts, delivery tracking possible
- ❌ Complex setup (Google Cloud Console, OAuth consent)
- ❌ Gmail-specific (not portable to other providers)
- 🎯 Best for: Production apps, Gmail-specific features needed
Rule of thumb: Prototype/learning → smtplib. Production Gmail app → Gmail API. Multi-provider production → SendGrid/AWS SES.
Exam Focus
Revise definitions, diagrams, examples, and short-answer points for Email Automation with Python.
Interview Use
Prepare one clear explanation, one practical example, and one common mistake for this Python Master Course topic.
Search Terms
python-master-course, python master course, python, master, course, automation, email, email automation with python
Related Python Master Course Topics
Continue learning this concept
AutomationPDF Automation with PythonMaster PDF automation with Python using PyPDF2, reportlab, pdfplumber for reading, writing, merging, splitting PDFs, extracting text/tables, and generating PDF reports.AutomationSelenium Web Automation with PythonMaster Selenium WebDriver with Python for browser automation, form filling, clicking, screenshots, handling dynamic content, waits, and headless browsing with Hindi explanations.AutomationTask Scheduler with PythonComplete guide to task scheduling in Python using schedule library, APScheduler, cron jobs, threading timers, and building automated workflows with Hindi explanations.AutomationWeb Scraping with PythonComplete guide to web scraping with Python using requests, BeautifulSoup4, lxml, handling pagination, scraping APIs, and best practices with Hindi explanations.Advanced PythonPython Asynchronous Programming with asyncioDeep dive into Python async/await, asyncio event loop, coroutines, tasks, async generators, aiohttp, and real-world asynchronous patterns with Hindi explanations.Advanced PythonPython Context ManagersComprehensive guide to Python context managers using with statement, __enter__ and __exit__ methods, contextlib module, nested context managers and custom resource management.