Hello!
Your payment was successfully received for Order #12345.
Thank you for your business!
\",\n mail_from=(sender_name, sender_email)\n)\n\n# Example of attaching a file (replace with a real file path if needed)\n# with open(\"receipt.pdf\", \"rb\") as f:\n# message.attach(filename=\"receipt.pdf\", data=f.read())\n\ntry:\n response = message.send(\n to=recipient_email,\n smtp={\n \"host\": SMTP_HOST,\n \"port\": SMTP_PORT,\n \"tls\": True, # Use TLS for secure connection\n \"user\": SMTP_USER,\n \"password\": SMTP_PASSWORD,\n },\n )\n\n if response.status_code == 250:\n print(\"Email sent successfully!\")\n else:\n print(f\"Failed to send email. Status code: {response.status_code}, Message: {response.message}\")\nexcept Exception as e:\n print(f\"An error occurred: {e}\")\n","lang":"python","description":"This quickstart example demonstrates how to create and send an HTML email using the `emails` library. It initializes an HTML email message with a subject, HTML body, and sender information. It then attempts to send the email via an SMTP server, retrieving SMTP credentials from environment variables for security. The example includes basic error handling for the `send` operation. For full functionality like HTML transformations or templating, remember to install the respective optional dependencies."},"warnings":[{"fix":"Upgrade your Python environment to 3.10 or later. Consider using a virtual environment to manage Python versions for different projects.","message":"Starting with version 1.0.0, 'emails' requires Python 3.10 or newer. Older Python 3.x versions (e.g., 3.9) are no longer supported.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Install with `pip install \"emails[html]\"` to include HTML transformation features.","message":"HTML transformation dependencies (like `cssutils`, `lxml`, `chardet`, `requests`, `premailer`) are no longer installed by default since version 1.0.0. If you use features like CSS inlining or image embedding, you must install the `html` extra.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"If you were using DKIM signing, you should now `import dkim` directly and ensure `dkimpy` is installed (implicitly handled by `emails` core requirements if using DKIM features).","message":"The vendored `emails.packages.dkim` module was replaced with the upstream `dkimpy` package in version 1.0.0. Direct imports from `emails.packages.dkim` will no longer work.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Install with `pip install \"emails[jinja]\"` to enable Jinja2 templating.","message":"Jinja2 template support is an optional dependency. If you intend to use `JinjaTemplate` or other Jinja2-based features, you must install the `jinja` extra.","severity":"gotcha","affected_versions":">=1.0.2"},{"fix":"Ensure all intended recipients are included in the `to` parameter when calling `message.send()`. If you want CC/BCC headers to appear, set them in the `Message` constructor as `cc='cc@example.com'` or `bcc='bcc@example.com'`.","message":"The `cc` and `bcc` parameters in the `Message` constructor are for setting email *headers* (e.g., to make recipients visible), not for adding recipients to the actual delivery list. All recipients, including CC/BCC recipients who should receive the email, must be specified in the `to` parameter of the `send()` method.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"search_vec":"'1.1.1':59 'activ':63 'address':68 'api':25 'appli':41 'async':81 'attach':34 'bug':72 'build':12 'compos':27 'construct':53 'current':56 'design':10 'dkim':46,80 'email':1,3,18,74,78 'emb':36 'featur':70 'file':35 'fix':73 'high':23 'high-level':22 'html':28,42,77 'html-email':76 'imag':38 'inlin':37 'level':24 'librari':4,61 'maintain':64 'manual':52 'messag':33 'mime':54,82 'modern':7 'new':69 'packag':9 'plain':31 'plain-text':30 'provid':20 'python':8 'regular':66 'releas':67 'render':39 'send':17,48 'sign':15,44 'smtp':50,75 'templat':13,40,79 'text':32 'transform':14,43 'tree':55 'version':58 'without':51","created_at":"2026-04-12T16:47:13.597728+00:00","updated_at":"2026-04-16T14:48:26.496028+00:00","problems":[{"fix":"Double-check your username and password for typos. If using a service like Gmail, generate and use an app-specific password, or ensure 'less secure app access' is enabled (though this option is often deprecated).","cause":"This error occurs when the email server rejects the provided username and password, often due to incorrect credentials, disabled 'less secure app access' (for services like Gmail), or the requirement for an app-specific password instead of the main account password.","error":"SMTPAuthenticationError"},{"fix":"Install the library using `pip install emails`. If the error persists, check your project directory for any files or folders named `emails.py` or `emails` and rename them to avoid conflicts.","cause":"The 'emails' library is not installed in the active Python environment, or there is a local Python file or directory named 'emails.py' or 'emails' in the current working directory, which shadows the actual installed library.","error":"ModuleNotFoundError: No module named 'emails'"},{"fix":"Ensure the email content is explicitly set as HTML with the correct character set. When using the `emails` library, ensure the `html` parameter is used and, if manually constructing MIME parts, set `Content-Type` to `text/html` and `charset` to `utf-8`. Example: `msg = email(html='...', charset='utf-8', ...)`","cause":"The email message is being interpreted as plain text by the recipient's email client because the content type is not explicitly set to HTML, or the character encoding is not correctly specified.","error":"HTML content not rendering in email / HTML tags shown in email body"},{"fix":"Verify the SMTP server address and port number. Check your network connectivity and any local firewall settings. If connecting to a specific email provider, consult their documentation for the correct SMTP configuration, including required SSL/TLS settings.","cause":"This error indicates that the connection to the SMTP server was terminated unexpectedly, often due to incorrect server host/port, network issues, firewall restrictions, or the server rejecting the connection due to an unsupported security protocol or policy.","error":"SMTPServerDisconnected: Connection unexpectedly closed"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.1.2","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/lavr/python-emails","docs":null,"changelog":null,"pypi":"https://pypi.org/project/emails/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["communication","serialization","auth-security"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-28","last_verified":"2026-08-30","next_check":"2026-07-28","install_tag":null}}