Bird
Raised Fist0
Flaskframework~5 mins

Sending simple emails in Flask

Choose your learning style10 modes available
LearnWhyDeepVisualTryChallengeProjectRecallPerf
Introduction

Sending emails lets your app talk to users by sending messages automatically. It helps with notifications, confirmations, or alerts.

Send a welcome email when someone signs up.
Notify users about password changes.
Send alerts for important events or errors.
Confirm orders or bookings automatically.
Syntax
Flask
from flask_mail import Mail, Message

app.config['MAIL_SERVER'] = 'smtp.example.com'
app.config['MAIL_PORT'] = 587
app.config['MAIL_USE_TLS'] = True
app.config['MAIL_USERNAME'] = 'your-email@example.com'
app.config['MAIL_PASSWORD'] = 'your-password'

mail = Mail(app)

msg = Message(subject='Hello', sender='your-email@example.com', recipients=['friend@example.com'])
msg.body = 'This is a simple email sent from Flask.'
mail.send(msg)

Configure your mail server settings before sending emails.

Use Message to create the email content and recipients.

Examples
Sends a plain text email with a subject and body.
Flask
msg = Message(subject='Hi', sender='me@example.com', recipients=['you@example.com'])
msg.body = 'Hello there!'
mail.send(msg)
Sends an email with HTML content instead of plain text.
Flask
msg = Message(subject='Greetings', sender='me@example.com', recipients=['you@example.com'])
msg.html = '<b>Bold hello!</b>'
mail.send(msg)
Sample Program

This Flask app sends a simple email when you visit /send-email. It uses Gmail SMTP settings and Flask-Mail to send the message.

Flask
from flask import Flask
from flask_mail import Mail, Message

app = Flask(__name__)

app.config['MAIL_SERVER'] = 'smtp.gmail.com'
app.config['MAIL_PORT'] = 587
app.config['MAIL_USE_TLS'] = True
app.config['MAIL_USERNAME'] = 'your-email@gmail.com'
app.config['MAIL_PASSWORD'] = 'your-app-password'

mail = Mail(app)

@app.route('/send-email')
def send_email():
    msg = Message(subject='Test Email', sender=app.config['MAIL_USERNAME'], recipients=['friend@example.com'])
    msg.body = 'Hello! This is a test email sent from Flask.'
    mail.send(msg)
    return 'Email sent successfully!'

if __name__ == '__main__':
    app.run(debug=True)
OutputSuccess
Important Notes

Use app passwords or OAuth for Gmail instead of your main password for security.

Make sure less secure app access is enabled or use app-specific passwords if needed.

Test emails with a real SMTP server or a service like Mailtrap for development.

Summary

Configure mail server settings in your Flask app.

Create a Message object with subject, sender, recipients, and body.

Use mail.send() to send the email.

Practice

(1/5)
1. What is the main purpose of the Message object in Flask-Mail when sending emails?
easy
A. To configure the mail server settings
B. To hold the email's subject, sender, recipients, and body content
C. To start the Flask application
D. To receive incoming emails

Solution

  1. Step 1: Understand the role of Message object

    The Message object is designed to store the email details like subject, sender, recipients, and body.

  2. Step 2: Differentiate from other components

    Mail server settings are configured separately, and Flask app startup is unrelated to Message. Receiving emails is not handled by Message.

  3. Final Answer:

    To hold the email's subject, sender, recipients, and body content -> Option B

  4. Quick Check:

    Message object = email content holder [OK]
Hint: Message object stores email details like subject and body [OK]
Common Mistakes:
  • Confusing Message with mail server configuration
  • Thinking Message starts the Flask app
  • Assuming Message receives emails
2. Which of the following is the correct way to send an email using Flask-Mail after creating a Message object named msg?
easy
A. mail.send(msg)
B. mail.send_message(msg)
C. send.mail(msg)
D. msg.send()

Solution

  1. Step 1: Recall Flask-Mail send syntax

    The correct method to send an email is mail.send(msg), where mail is the Mail instance and msg is the Message object.

  2. Step 2: Identify incorrect method names

    Options like mail.send_message, send.mail, and msg.send() are not valid Flask-Mail methods.

  3. Final Answer:

    mail.send(msg) -> Option A

  4. Quick Check:

    Send email = mail.send(msg) [OK]
Hint: Use mail.send() with Message object to send email [OK]
Common Mistakes:
  • Using incorrect method names like send_message
  • Calling send on the Message object
  • Reversing mail and send order
3. Given the following Flask-Mail code snippet, what will be the output or result?
from flask_mail import Message
msg = Message(subject='Hello', sender='me@example.com', recipients=['you@example.com'], body='Hi there!')
mail.send(msg)
medium
A. An email with subject 'Hello' is sent from me@example.com to you@example.com with body 'Hi there!'
B. SyntaxError because Message requires a different parameter order
C. No email sent because body is missing
D. NameError because mail is not defined

Solution

  1. Step 1: Check code completeness

    The snippet uses mail.send(msg) but does not show the mail object being created or initialized.

  2. Step 2: Understand Flask-Mail usage

    Without initializing mail with Flask app and configuration, calling mail.send() will cause a NameError because mail is undefined.

  3. Final Answer:

    NameError because mail is not defined -> Option D

  4. Quick Check:

    Undefined mail object = NameError [OK]
Hint: Ensure mail is initialized before calling mail.send() [OK]
Common Mistakes:
  • Assuming mail is auto-created
  • Thinking parameter order causes syntax error
  • Ignoring missing body error
4. Identify the error in this Flask-Mail email sending code:
msg = Message('Greetings', sender='admin@example.com', recipients='user@example.com', body='Welcome!')
mail.send(msg)
medium
A. The recipients parameter should be a list, not a string
B. The sender email is missing '@' symbol
C. The Message subject must be passed as a keyword argument
D. mail.send() requires two arguments

Solution

  1. Step 1: Check recipients parameter type

    The recipients argument must be a list of email addresses, but here it is a string.

  2. Step 2: Validate other parameters

    The sender email is valid, subject can be positional, and mail.send() takes one argument (the Message object).

  3. Final Answer:

    The recipients parameter should be a list, not a string -> Option A

  4. Quick Check:

    Recipients must be list = The recipients parameter should be a list, not a string [OK]
Hint: Recipients must always be a list, even for one email [OK]
Common Mistakes:
  • Passing recipients as a string
  • Misplacing subject argument
  • Expecting mail.send() to take multiple arguments
5. You want to send an email with Flask-Mail only if the recipient list is not empty and the body text is not empty. Which code snippet correctly implements this check before sending?
hard
A. msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg)
B. if recipients or body: msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg)
C. if recipients and body: msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg)
D. if not recipients and not body: msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg)

Solution

  1. Step 1: Understand the condition logic

    We want to send email only if both recipients and body are not empty, so use if recipients and body:.

  2. Step 2: Analyze each option

    if recipients and body: msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg) uses correct and condition. if recipients or body: msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg) uses or which sends email if either is present. if not recipients and not body: msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg) sends email if both are empty (wrong). msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg) sends email unconditionally.

  3. Final Answer:

    if recipients and body: msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg) -> Option C

  4. Quick Check:

    Send only if both present = if recipients and body: msg = Message(subject='Hi', sender='me@example.com', recipients=recipients, body=body) mail.send(msg) [OK]
Hint: Use 'and' to check both recipients and body before sending [OK]
Common Mistakes:
  • Using 'or' instead of 'and' for condition
  • Sending email without any checks
  • Checking for empty strings incorrectly
Recommended

Ready to prove it?

Pass the test and this pattern moves unknown strong while earning +1 Grip toward your certificate.

10 questions~5 mineasy hard