{"id":210,"date":"2023-12-09T15:10:28","date_gmt":"2023-12-09T15:10:28","guid":{"rendered":"https:\/\/mailmug.net\/blog\/?p=210"},"modified":"2023-12-13T03:23:33","modified_gmt":"2023-12-13T03:23:33","slug":"python-send-email","status":"publish","type":"post","link":"https:\/\/mailmug.net\/blog\/python-send-email\/","title":{"rendered":"Python Send Email Using SMTP Library"},"content":{"rendered":"\n

Discover the power of Python’s SMTP library for sending emails (Python send email tutorial). Learn how to effortlessly send HTML or plain-text emails to multiple recipients with seamless attachment support. The SMTPlib<\/strong> is the most popular Python SMTP<\/a><\/strong> library. <\/p>\n\n\n\n

<\/p>\n\n\n\n

Navigate to specific topics instantly by clicking on the entries in the table of contents below.<\/p>\n\n\n\n

    \n
  1. Python Email SMTP Library<\/a><\/li>\n\n\n\n
  2. SMTP Sandbox Account<\/a><\/li>\n\n\n\n
  3. Sending Email with Python via Gmail<\/a><\/li>\n\n\n\n
  4. Send Plain-Text Python Email Example<\/a><\/li>\n\n\n\n
  5. Send an HTML Email With Python<\/a><\/li>\n\n\n\n
  6. Send Email With Attachments<\/a><\/li>\n\n\n\n
  7. Send Email to Multiple Recipients<\/a><\/li>\n\n\n\n
  8. SMTPlib Bcc , Cc, Reply-to<\/a><\/li>\n\n\n\n
  9. Use a Variable on smtplib<\/a><\/li>\n\n\n\n
  10. Errors<\/li>\n<\/ol>\n\n\n\n
    <\/div>\n\n\n\n

    1. Python Email SMTP Library<\/h2>\n\n\n\n

    The SMTPlib is most popular Python SMTP (Simple Mail Transfer Protocol) library. The smtplib<\/code> is an in-built library in Python. It is part of the standard library, which means you don’t need to install any additional packages <\/strong>to use it.<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    2. SMTP Sandbox Account<\/h2>\n\n\n\n

    Unlock the benefits of MailMug’s<\/a> complimentary SMTP sandbox account by signing up. Once your account is created, navigate to the Settings section, where you can conveniently copy and paste the provided SMTP credentials from your MailMug account for seamless integration.<\/p>\n\n\n\n

    \"SMPT<\/a><\/figure>\n\n\n\n
    <\/div>\n\n\n\n

    3. Sending Email with Python via Gmail<\/h2>\n\n\n\n

    Google (gmail) is providing free SMTP server. First, we need to enable two step verification<\/a><\/strong> for your gmail account. <\/p>\n\n\n\n

    \"gmail<\/a><\/figure>\n\n\n\n

    Next, generate an app password by following these steps:<\/p>\n\n\n\n

      \n
    1. Visit your Google account<\/a><\/strong> settings.<\/li>\n\n\n\n
    2. Navigate to the Security<\/strong> section.<\/li>\n\n\n\n
    3. Select 2-Step Verification<\/strong> > App passwords <\/strong>(bottom).<\/strong><\/li>\n\n\n\n
    4. Create a new app password.<\/li>\n<\/ol>\n\n\n\n
      \"smtp<\/figure>\n\n\n\n

      Now, input the credentials as outlined below.<\/p>\n\n\n

      \nHost: smtp.gmail.com\n\nUsername: youremail@gmail.com\n\nPassword: {app password}\n\nSecure(SSL)\n\nPort(465)\n<\/pre><\/div>\n\n
      \nimport smtplib, ssl\n\nport = 465  \npassword = "app password here"\ncontext = ssl.create_default_context()\n\nwith smtplib.SMTP_SSL("smtp.gmail.com", port, context=context) as server:\n    server.login("your-email@gmail.com", password)\n<\/pre><\/div>\n\n\n
      <\/div>\n\n\n\n
      4. Send Plain-Text Python Email Example<\/h2>\n\n\n\n
      Create a\u00a0main.py<\/strong>\u00a0file then add the following code. Import smtplib<\/strong>, MIMEText<\/strong> and MIMEMultipart<\/strong> packages.  The smtplib is helping to communicate with SMTP server.  The email.mime.text<\/code><\/strong> is a submodule that provides classes for creating MIME<\/strong> (Multipurpose Internet Mail Extensions) objects. The MIMEMultipart<\/strong><\/code> is a class that represents a MIME multipart message.<\/p>\n\n\n
      \nimport smtplib\nfrom email.mime.text import MIMEText\nfrom email.mime.multipart import MIMEMultipart\n  \n  \nport = 2525\nsmtp_server = "smtp.mailmug.net"\nlogin = "username here" # paste your login generated by mailmug\npassword = "pass here" # paste your password generated by mailmug\n  \nsender_email = "mailmug@example.com"\nreceiver_email = "new@example.com"\nmessage = MIMEMultipart("alternative")\nmessage["Subject"] = "Test subject"\nmessage["From"] = sender_email\nmessage["To"] = receiver_email\n  \n  \n  \ntext = """\\\n    hi, How are you?\n    """\npart = MIMEText(text, "plain")\nmessage.attach(part)\n\nserver = smtplib.SMTP(smtp_server, port)\nserver.set_debuglevel(1)\nserver.esmtp_features['auth'] = 'LOGIN DIGEST-MD5 PLAIN'\nserver.login(login, password)\nserver.sendmail(\n    sender_email, receiver_email, message.as_string()\n)\n  \n  \n \n<\/pre><\/div>\n\n\n
      <\/p>\n\n\n\n
      <\/div>\n\n\n\n
      Python Send HTML Email<\/h2>\n\n\n\n
      The Python HTML email template by MIMEText class. MIMEText(html, \"html\")<\/code><\/p>\n\n\n\n
      Change style by css<\/strong> codes in head section of the email html.<\/p>\n\n\n
      \nimport smtplib\nfrom email.mime.text import MIMEText\nfrom email.mime.multipart import MIMEMultipart\n  \n  \nport = 2525\nsmtp_server = "smtp.mailmug.net"\nlogin = "username here" # paste your login generated by mailmug\npassword = "pass here " # paste your password generated by mailmug\n  \nsender_email = "mailmug@example.com"\nreceiver_email = "new@example.com"\nmessage = MIMEMultipart("alternative")\nmessage["Subject"] = "Test subject"\nmessage["From"] = sender_email\nmessage["To"] = receiver_email\n  \n  \n  \nhtml = """\\\n    <!DOCTYPE html>\n<html lang="en">\n<head>\n    <meta charset="UTF-8">\n    <meta name="viewport" content="width=device-width, initial-scale=1.0">\n    <title>Your Email Title<\/title>\n    <style>\n        \/* Add your styles here *\/\n        body {\n            font-family: Arial, sans-serif;\n            background-color: #f4f4f4;\n            margin: 0;\n            padding: 50px;\n        }\n\n        .container {\n            max-width: 600px;\n            margin: 0 auto;\n            padding: 20px;\n            background-color: #ffffff;\n        }\n\n        h1 {\n            color: #333333;\n        }\n\n        p {\n            color: #555555;\n        }\n\n        \/* Add more styles as needed *\/\n    <\/style>\n<\/head>\n<body>\n    <div class="container">\n        <h1>Your Email Heading<\/h1>\n        <p>This is a basic HTML email template. You can customize it to suit your needs.<\/p>\n\n        <!-- Add your email content here -->\n\n        <p>Thank you!<\/p>\n    <\/div>\n<\/body>\n<\/html>\n    """\npart = MIMEText(html, "html")\nmessage.attach(part)\n\nserver = smtplib.SMTP(smtp_server, port)\nserver.set_debuglevel(1)\nserver.esmtp_features['auth'] = 'LOGIN DIGEST-MD5 PLAIN'\nserver.login(login, password)\nserver.sendmail(\n    sender_email, receiver_email, message.as_string()\n)\n  \n  \n \n<\/pre><\/div>\n\n\n
      \"Python<\/a><\/figure>\n\n\n\n
      <\/div>\n\n\n\n
      Send Email With Attachments<\/h2>\n\n\n\n
      Sending emails with file attachments is facilitated through the MIMEApplication<\/strong> class, specifically designed for encoding non-text characters. Utilizing base64<\/strong> encoding, this class allows for the inclusion of file data. Retrieve the file data, store it within the MIMEApplication<\/strong> object, and seamlessly attach multiple files by iterating through the file array.<\/p>\n\n\n\n
      Import following libraries<\/p>\n\n\n\n
      from email.mime.application import MIMEApplication<\/code><\/p>\n\n\n\n
      from os.path import basename<\/code><\/p>\n\n\n\n
      The base basename<\/code> is using to get filename from file path.<\/p>\n\n\n\n
      The Python Send Email with Attachemnts Example<\/strong><\/p>\n\n\n
      \nimport smtplib\nfrom email.mime.text import MIMEText\nfrom email.mime.multipart import MIMEMultipart\nfrom email.mime.application import MIMEApplication\nfrom os.path import basename\n\n  \nport = 2525\nsmtp_server = "smtp.mailmug.net"\nlogin = "user name" # paste your login generated by mailmug\npassword = "pass " # paste your password generated by mailmug\n  \nsender_email = "mailmug@example.com"\nreceiver_email = "new@example.com"\nmessage = MIMEMultipart("alternative")\nmessage["Subject"] = "Test subject"\nmessage["From"] = sender_email\nmessage["To"] = receiver_email\n  \n  \n  \nhtml = """\\\n    <!DOCTYPE html>\n<html lang="en">\n<head>\n    <meta charset="UTF-8">\n    <meta name="viewport" content="width=device-width, initial-scale=1.0">\n    <title>Your Email Title<\/title>\n    <style>\n        \/* Add your styles here *\/\n        body {\n            font-family: Arial, sans-serif;\n            background-color: #f4f4f4;\n            margin: 0;\n            padding: 50px;\n        }\n\n        .container {\n            max-width: 600px;\n            margin: 0 auto;\n            padding: 20px;\n            background-color: #ffffff;\n        }\n\n        h1 {\n            color: #333333;\n        }\n\n        p {\n            color: #555555;\n        }\n\n        \/* Add more styles as needed *\/\n    <\/style>\n<\/head>\n<body>\n    <div class="container">\n        <h1>Your Email Heading<\/h1>\n        <p>This is a basic HTML email template. You can customize it to suit your needs.<\/p>\n\n        <!-- Add your email content here -->\n\n        <p>Thank you!<\/p>\n    <\/div>\n<\/body>\n<\/html>\n    """\npart = MIMEText(html, "html")\nmessage.attach(part)\nfiles = ['my.jpg']\nfor f in files:\n    with open(f, "rb") as fil:\n        file_part = MIMEApplication(\n            fil.read(),\n            Name=basename(f)\n        )\n    file_part['Content-Disposition'] = 'attachment; filename="%s"' % basename(f)\n    message.attach(file_part)\n\n\nserver = smtplib.SMTP(smtp_server, port)\nserver.set_debuglevel(1)\nserver.esmtp_features['auth'] = 'LOGIN DIGEST-MD5 PLAIN'\nserver.login(login, password)\nserver.sendmail(\n    sender_email, receiver_email, message.as_string()\n)\n  \n  \n \n<\/pre><\/div>\n\n\n
      <\/div>\n\n\n\n
      Send Email to Multiple Recipients<\/h2>\n\n\n\n
      Sending emails to multiple recipients can be achieved by incorporating a list of email addresses into the receiver_email<\/code> parameter within the smtplib<\/code> library.<\/p>\n\n\n\n
      receiver_email = [\"new@example.com\", \"new1@example.com\"]<\/code><\/p>\n\n\n\n
      Complete code:<\/strong>–<\/p>\n\n\n
      \nimport smtplib\nfrom email.mime.text import MIMEText\nfrom email.mime.multipart import MIMEMultipart\nfrom email.mime.application import MIMEApplication\nfrom os.path import basename\n\n  \nport = 2525\nsmtp_server = "smtp.mailmug.net"\nlogin = " " # paste your login generated by mailmug\npassword = " " # paste your password generated by mailmug\n  \nsender_email = "mailmug@example.com"\nreceiver_email =  ["new@example.com", "new1@example.com"]\nmessage = MIMEMultipart("alternative")\nmessage["Subject"] = "Test subject"\nmessage["From"] = sender_email\n\nif isinstance(receiver_email, str):\n    message["To"] = receiver_email\nelse:\n    message["To"] = ", ".join(receiver_email)\n  \n  \n  \nhtml = """\\\n    <!DOCTYPE html>\n<html lang="en">\n<head>\n    <meta charset="UTF-8">\n    <meta name="viewport" content="width=device-width, initial-scale=1.0">\n    <title>Your Email Title<\/title>\n    <style>\n        \/* Add your styles here *\/\n        body {\n            font-family: Arial, sans-serif;\n            background-color: #f4f4f4;\n            margin: 0;\n            padding: 50px;\n        }\n\n        .container {\n            max-width: 600px;\n            margin: 0 auto;\n            padding: 20px;\n            background-color: #ffffff;\n        }\n\n        h1 {\n            color: #333333;\n        }\n\n        p {\n            color: #555555;\n        }\n\n        \/* Add more styles as needed *\/\n    <\/style>\n<\/head>\n<body>\n    <div class="container">\n        <h1>Your Email Heading<\/h1>\n        <p>This is a basic HTML email template. You can customize it to suit your needs.<\/p>\n\n        <!-- Add your email content here -->\n\n        <p>Thank you!<\/p>\n    <\/div>\n<\/body>\n<\/html>\n    """\npart = MIMEText(html, "html")\nmessage.attach(part)\nfiles = ['my.jpg']\nfor f in files:\n    with open(f, "rb") as fil:\n        file_part = MIMEApplication(\n            fil.read(),\n            Name=basename(f)\n        )\n    file_part['Content-Disposition'] = 'attachment; filename="%s"' % basename(f)\n    message.attach(file_part)\n\n\nserver = smtplib.SMTP(smtp_server, port)\nserver.set_debuglevel(1)\nserver.esmtp_features['auth'] = 'LOGIN DIGEST-MD5 PLAIN'\nserver.login(login, password)\nserver.sendmail(\n    sender_email, receiver_email, message.as_string()\n)\n  \n  \n \n<\/pre><\/div>\n\n\n
      \"Multiple<\/a><\/figure>\n\n\n\n
      <\/div>\n\n\n\n
      <\/p>\n\n\n\n
      SMTPlib Bcc , Cc, Reply-to<\/h2>\n\n\n\n
      Include ‘Cc,’ ‘Bcc,’ or ‘Reply-To’ information in the MIMEMultipart message, and it will be seamlessly added to the email header section.<\/p>\n\n\n\n
      Example<\/strong>:-<\/p>\n\n\n\n
      <\/p>\n\n\n\n
      message[\"Bcc\"] = \"bcc@example.com\"
      message[\"Cc\"] = \"cc@example.com\"<\/code><\/p>\n\n\n\n
      message[\"Reply-to\"] = \"cc@example.com\"<\/code><\/p>\n\n\n\n
      \"python<\/a><\/figure>\n\n\n\n
      <\/div>\n\n\n\n
      Use a Variable on smtplib<\/h2>\n\n\n\n
      Replace variables from HTML message by replace<\/code> function as shortcode.<\/p>\n\n\n\n
      Example<\/strong>:<\/p>\n\n\n
      \nname = 'Any name here'\nmessage = "Hi [name] \\\nHow can I help you?"\n\nmessage = message.replace('[name'], name)\n<\/pre><\/div>\n\n\n
      <\/div>\n\n\n\n
      TimeoutError Trying To Send an Email with SMTPlib<\/h2>\n\n\n\n
      The smtplib<\/strong><\/code> TimeoutError<\/strong> indicates that the connection to the SMTP server timed out.<\/p>\n\n\n\n
      Check SMTP Server and Port:<\/strong><\/p>\n\n\n\n