Sending emails with Python allows applications to automatically send messages to users, customers, or other systems. Python provides the built-in smtplib module for communicating with mail servers using the Simple Mail Transfer Protocol (SMTP). The email package can also be used to create structured email messages with subjects, text, HTML content, and attachments. Email automation is useful for notifications, reports, alerts, and other application tasks.

Table of Contents

What is Sending Emails with Python?

Sending emails with Python means using Python code to connect to an email server and send messages automatically. The smtplib module provides the functionality required to communicate with an SMTP server.
Python can also use the email package to create more detailed email messages containing subjects, HTML content, and attachments.

Why Send Emails Using Python?

Python email automation can be useful when an application needs to send messages without requiring manual action.

1. Automation: Python can send emails automatically when a specific event occurs.
2. Notifications: Applications can send alerts and notifications to users.
3. Reports: Python can automatically send generated reports through email.
4. Communication: Programs can send information to multiple recipients.
5. Integration: Email functionality can be integrated into Python applications and automated workflows.

SMTP in Python

SMTP stands for Simple Mail Transfer Protocol. It is a protocol used to send emails between mail servers.
Python's smtplib module provides an SMTP client that can be used to connect to an SMTP server and send email messages.
The SMTP server, port, and security settings depend on the email service being used.

Importing Required Modules

The smtplib module is used to establish a connection with an SMTP server.

import smtplib

The email package can be used when creating structured email messages.

from email.message import EmailMessage

Sending a Simple Email

The following example demonstrates the basic structure for sending an email through an SMTP server. Replace the placeholder server, email address, and password with the appropriate values for the email service being used.

Example:

# Python program to send a simple email
import smtplib
sender = "sender@example.com"
receiver = "receiver@example.com"
password = "your_password"
message = "Hello, this is an email sent using Python."
with smtplib.SMTP("smtp.example.com", 587) as server:
    server.starttls()
    server.login(sender, password)
    server.sendmail(sender, receiver, message)
print("Email sent successfully.")

Output:

Email sent successfully.

The SMTP server address and authentication requirements vary depending on the email provider.

Sending an Email with a Subject

The EmailMessage class can be used to create an email with a subject, sender, recipient, and message body.

Example:

# Python program to send an email with a subject
import smtplib
from email.message import EmailMessage
sender = "sender@example.com"
receiver = "receiver@example.com"
password = "your_password"
message = EmailMessage()
message["Subject"] = "Python Email"
message["From"] = sender
message["To"] = receiver
message.set_content("Hello, this email was sent using Python.")
with smtplib.SMTP("smtp.example.com", 587) as server:
    server.starttls()
    server.login(sender, password)
    server.send_message(message)
print("Email sent successfully.")

Output:

Email sent successfully.

Sending an Email to Multiple Recipients

Multiple recipients can be specified by providing a list of email addresses.

Example:

# Python program to send an email to multiple recipients
import smtplib
from email.message import EmailMessage
sender = "sender@example.com"
recipients = ["user1@example.com", "user2@example.com"]
password = "your_password"
message = EmailMessage()
message["Subject"] = "Python Notification"
message["From"] = sender
message["To"] = ", ".join(recipients)
message.set_content("This email was sent to multiple recipients.")
with smtplib.SMTP("smtp.example.com", 587) as server:
    server.starttls()
    server.login(sender, password)
    server.send_message(message)
print("Email sent successfully.")

Output:

Email sent successfully.

Sending an HTML Email

The EmailMessage class can send HTML content by using the add_alternative() method.

Example:

# Python program to send an HTML email
import smtplib
from email.message import EmailMessage
sender = "sender@example.com"
receiver = "receiver@example.com"
password = "your_password"
message = EmailMessage()
message["Subject"] = "HTML Email"
message["From"] = sender
message["To"] = receiver
message.set_content("This email contains HTML content.")
message.add_alternative(
    """
    <html>
        <body>
            <h1>Hello!</h1>
            <p>This is an HTML email sent using Python.</p>
        </body>
    </html>
    """,
    subtype="html"
)
with smtplib.SMTP("smtp.example.com", 587) as server:
    server.starttls()
    server.login(sender, password)
    server.send_message(message)
print("HTML email sent successfully.")

Output:

HTML email sent successfully.

Sending an Email with an Attachment

The EmailMessage class can also be used to attach files to an email.

Example:

# Python program to send an email with an attachment
import smtplib
from email.message import EmailMessage
sender = "sender@example.com"
receiver = "receiver@example.com"
password = "your_password"
message = EmailMessage()
message["Subject"] = "File Attachment"
message["From"] = sender
message["To"] = receiver
message.set_content("Please find the attached file.")
with open("report.txt", "rb") as file:
    file_data = file.read()
message.add_attachment(
    file_data,
    maintype="text",
    subtype="plain",
    filename="report.txt"
)
with smtplib.SMTP("smtp.example.com", 587) as server:
    server.starttls()
    server.login(sender, password)
    server.send_message(message)
print("Email with attachment sent successfully.")

Output:

Email with attachment sent successfully.

Advantages of Sending Emails with Python

• Automation: Python can send emails automatically without requiring manual intervention.
• Notifications: Applications can send important notifications and alerts to users.
• Report Delivery: Programs can automatically send reports and generated files through email.
• Customization: Emails can contain plain text, HTML content, and file attachments.
• Integration: Email functionality can be integrated into applications, scripts, and automated workflows.

Common Beginner Mistakes

1. Using Incorrect SMTP Details: Beginners may use an incorrect SMTP server address or port number.
2. Exposing Email Credentials: Email passwords or authentication credentials should not be written directly in publicly shared source code.
3. Forgetting SMTP Security: Beginners may forget to use the appropriate secure connection or encryption method required by the email provider.
4. Using Invalid Email Addresses: Incorrect sender or recipient addresses can cause an email to fail.
5. Ignoring Authentication Requirements: Some email providers require specific authentication methods, such as an app password or other supported authentication mechanism.

Conclusion

Python provides useful tools for sending emails automatically through SMTP. The smtplib module can establish a connection with an email server, while the email package can create structured messages with subjects, HTML content, and attachments. Email automation can be useful for notifications, reports, alerts, and other application workflows.

Frequently Asked Questions

1. Which module is used to send emails in Python?

The built-in smtplib module is commonly used to connect to an SMTP server and send emails in Python.

2. What is SMTP?

SMTP stands for Simple Mail Transfer Protocol and is used to send emails between mail servers.

3. Can Python send HTML emails?

Yes, Python can send HTML emails by using the EmailMessage class and the add_alternative() method.

4. Can Python send email attachments?

Yes, the EmailMessage class provides the add_attachment() method for adding files to an email.

5. Is it safe to store email passwords directly in Python code?

No, email passwords and other authentication credentials should not be exposed directly in source code, especially when the code is shared or published.