Package: django-anymail
Anymail lets you send and receive email in Django using your choice
of transactional email service providers (ESPs). It extends the
standarddjango.core.mailwith many common ESP-added features, providing
a consistent API that avoids locking your code to one specific ESP
(and making it easier to change ESPs later if needed).Anymail currently supports these ESPs:Amazon SESBrevo(formerly SendinBlue)MailerSendMailgunMailjetMandrill(MailChimp transactional)Postal(self-hosted ESP)PostmarkResendSendGridSparkPostAnymail includes:Integration of each ESP’s sending APIs intoDjango’s built-in emailpackage, including support for HTML, attachments, extra headers,
and other standard email featuresExtensions to expose common ESP-added functionality, like tags, metadata,
and tracking, with code that’s portable between ESPsSimplified inline images for HTML emailNormalized sent-message status and tracking notification, by connecting
your ESP’s webhooks to Django signals“Batch transactional” sends using your ESP’s merge and template featuresInbound message support, to receive email through your ESP’s webhooks,
with simplified, portable access to attachments and other inbound contentAnymail maintains compatibility with all Django versions that are in mainstream
or extended support, plus (usually) a few older Django versions, and is extensively
tested on all Python versions supported by Django. (Even-older Django versions
may still be covered by an Anymail extended support release; consult thechangelogfor details.)Anymail releases followsemantic versioning.
The package is released under the BSD license.ResourcesFull documentation:https://anymail.dev/en/v10.2/Help and troubleshooting:https://anymail.dev/en/v10.2/help/Package on PyPI:https://pypi.org/project/django-anymail/Project on Github:https://github.com/anymail/django-anymailChangelog:https://anymail.dev/en/v10.2/changelog/Anymail 1-2-3Here’s how to send a message.
This example uses Mailgun, but you can substitute Mailjet or Postmark or SendGrid
or SparkPost or any other supported ESP where you see “mailgun”:Install Anymail from PyPI:$pipinstall"django-anymail[mailgun]"(The[mailgun]part installs any additional packages needed for that ESP.
Mailgun doesn’t have any, but some other ESPs do.)Edit your project’ssettings.py:INSTALLED_APPS=[# ..."anymail",# ...]ANYMAIL={# (exact settings here depend on your ESP...)"MAILGUN_API_KEY":"<your Mailgun key>","MAILGUN_SENDER_DOMAIN":'mg.example.com',# your Mailgun domain, if needed}EMAIL_BACKEND="anymail.backends.mailgun.EmailBackend"# or sendgrid.EmailBackend, or...DEFAULT_FROM_EMAIL="you@example.com"# if you don't already have this in settingsSERVER_EMAIL="your-server@example.com"# ditto (default from-email for Django errors)Now the regularDjango email functionswill send through your chosen ESP:fromdjango.core.mailimportsend_mailsend_mail("It works!","This will get sent through Mailgun","Anymail Sender <from@example.com>",["to@example.com"])You could send an HTML message, complete with an inline image,
custom tags and metadata:fromdjango.core.mailimportEmailMultiAlternativesfromanymail.messageimportattach_inline_image_filemsg=EmailMultiAlternatives(subject="Please activate your account",body="Click to activate your account: https://example.com/activate",from_email="Example <admin@example.com>",to=["New User <user1@example.com>","account.manager@example.com"],reply_to=["Helpdesk <support@example.com>"])# Include an inline image in the html:logo_cid=attach_inline_image_file(msg,"/path/to/logo.jpg")html="""<img alt="Logo" src="cid:{logo_cid}">
          <p>Please <a href="https://example.com/activate">activate</a>
          your account</p>""".format(logo_cid=logo_cid)msg.attach_alternative(html,"text/html")# Optional Anymail extensions:msg.metadata={"user_id":"8675309","experiment_variation":1}msg.tags=["activation","onboarding"]msg.track_clicks=True# Send it:msg.send()See thefull documentationfor more features and options, including receiving messages and tracking
sent message status.