lettermint-django 0.2.1a0

Django email backend for Lettermint

lettermint-django

An unofficial Django email backend for Lettermint. Drop it in as your EMAIL_BACKEND and all Django mail (send_mail(), EmailMessage, EmailMultiAlternatives) routes through the Lettermint API. Supports per-message routing, HTML emails, attachments, and reply-to headers with no changes to your existing email code.

Built and maintained by zzinnovate. Not affiliated with Lettermint.

Documentation

📖 View Full Documentation →

• Getting Started: Installation • Configuration • Usage
• Reference: Settings • Backend
• Project: Contributing • Changelog • Security

Requirements

• Python 3.11+ (Django 6 requires Python 3.12+)
• Django 4.2, 5.x, or 6.x
• lettermint 2.0+

Install

pip install lettermint-django

# For development (includes testing tools)
pip install -e ".[dev]"

Quick start

import os

EMAIL_BACKEND = "lettermint_django.LettermintEmailBackend"
LETTERMINT_API_KEY = os.getenv("LETTERMINT_API_KEY")

That's it. All send_mail(), EmailMessage, and EmailMultiAlternatives calls in Django will now route through Lettermint.

Settings Reference

Setting	Required	Default	Description
LETTERMINT_API_KEY	Yes	-	Your project API token from the Lettermint dashboard
LETTERMINT_BASE_URL	No	SDK default	Override the Lettermint API base URL
LETTERMINT_ROUTE	No	-	Default route applied to all outgoing emails
LETTERMINT_TIMEOUT	No	SDK default	Request timeout in seconds

Per-message Route

Override the route for a specific message via extra_headers:

from django.core.mail import EmailMessage

msg = EmailMessage(
    subject="Password reset",
    body="Click the link...",
    from_email="[e-mail]",
    to=["[e-mail]"],
)
msg.extra_headers["X-Lettermint-Route"] = "transactional"
msg.send()

HTML Emails

from django.core.mail import EmailMultiAlternatives

msg = EmailMultiAlternatives(
    subject="Welcome",
    body="Plain text fallback.",
    from_email="[e-mail]",
    to=["[e-mail]"],
)
msg.attach_alternative("<h1>Hello!</h1>", "text/html")
msg.send()

Contributing

Contributions are welcome. See CONTRIBUTING.md for development setup, testing, and workflow guidelines.

Security

See SECURITY.md for reporting vulnerabilities and best practices.

Credits

This package is built on top of the official lettermint Python SDK, which handles all API communication.

• Sjoerd Zaalberg van Zelst (zzinnovate)
• All contributors

License

MIT. See LICENSE.