[tutorial] Using Mailgun + Python to send email

📌 Introduction

This tutorial covers how to send emails using Mailgun and Python. You’ll learn how to set up Mailgun, generate an API key, and write Python code to send emails with or without attachments.

🚀 Quick Start

Mailgun

• Mailgun provides a free plan allows sending up to 100 emails per day.

Here are three things you need to do

1. Generate a Mailgun API key
2. Remember your Mailgun domain name (used for sending email)
3. Add your email to Mailgun (Mailgun only allows sending an email to authorized recipients)

Create an API key

Get your domain from Mailgun

Set up your email & verify it

1. Add your email to mailgun
2. Check your mailbox to verify it

Python

To see the entire code : mailgun/demo.py

MAILGUN_API_KEY = os.getenv("MAILGUN_API_KEY")
MAILGUN_DOMAIN_NAME = os.getenv("MAILGUN_DOMAIN_NAME")
MAILGUN_API_URL = (
    f"https://api.mailgun.net/v3/{MAILGUN_DOMAIN_NAME}.mailgun.org/messages"
)

@error_handler_for_send_email
def send_email(from_email: str, to_email: Union[str, list], subject: str, text: str):
    # Define the email parameters
    email_data = {"from": from_email, "to": to_email, "subject": subject, "text": text}

    # Send the email
    r = requests.post(
        url=MAILGUN_API_URL, auth=("api", MAILGUN_API_KEY), data=email_data
    )

    return r

@error_handler_for_send_email
def send_email_with_attachment(
    from_email: str,
    to_email: Union[str, list],
    subject: str,
    text: str,
    attachment_paths: list,
):
    # Define the email parameters
    email_data = {"from": from_email, "to": to_email, "subject": subject, "text": text}

    # Read the attachment
    files = [
        ("attachment", open(attachment_path, "rb"))
        for attachment_path in attachment_paths
    ]

    # Send the email
    r = requests.post(
        url=MAILGUN_API_URL, auth=("api", MAILGUN_API_KEY), data=email_data, files=files
    )

    return r

Gmail

After sending the email from Mailgun, you can check your inbox. It might be marked as spam, so you can check your spam folder to see if the email is there.

🔁 Recap

• Mailgun Setup: Generate an API key, retrieve your domain name, and verify your email
• Python Integration: Use the Mailgun API with Python to send emails programmatically
• Sending Attachments: Learn how to send emails with attachments using the Mailgun API

🔗 References

• https://www.mailgun.com/blog/it-and-engineering/send-email-using-python/
• https://stackoverflow.com/questions/53861582/sent-email-via-python-using-mailgun-api