GitHub - anymail/django-anymail: Django email backends and webhooks for Amazon SES, Brevo (Sendinblue), MailerSend, Mailgun, Mailjet, Postmark, Postal, Resend, SendGrid, SparkPost, Unisender Go and more (original) (raw)

Anymail: Django email integration for transactional ESPs

Anymail lets you send and receive email in Django using your choice of transactional email service providers (ESPs). It extends the standard django.core.mail with 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 SES
• Brevo (formerly SendinBlue)
• MailerSend
• Mailgun (Sinch transactional email)
• Mailjet (Sinch transactional email)
• Mandrill (MailChimp transactional email)
• Postal (self-hosted ESP)
• Postmark (ActiveCampaign transactional email)
• Resend
• SendGrid (Twilio transactional email)
• SparkPost (Bird transactional email)
• Unisender Go

Anymail includes:

• Integration of each ESP's sending APIs intoDjango's built-in emailpackage, including support for HTML, attachments, extra headers, and other standard email features
• Extensions to expose common ESP-added functionality, like tags, metadata, and tracking, with code that's portable between ESPs
• Simplified inline images for HTML email
• Normalized 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 features
• Inbound message support, to receive email through your ESP's webhooks, with simplified, portable access to attachments and other inbound content

Anymail 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 thechangelog for details.)

Anymail releases follow semantic versioning. The package is released under the BSD license.

Resources

• Full documentation: https://anymail.dev/en/stable/
• Help and troubleshooting: https://anymail.dev/en/stable/help/
• Package on PyPI: https://pypi.org/project/django-anymail/
• Project on Github: https://github.com/anymail/django-anymail
• Changelog: https://anymail.dev/en/stable/changelog/

Anymail 1-2-3

Here'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":

1. Install Anymail from PyPI:
   $ pip install "django-anymail[mailgun]"
   (The [mailgun] part installs any additional packages needed for that ESP. Mailgun doesn't have any, but some other ESPs do.)
2. Edit your project's settings.py:
   INSTALLED_APPS = [

   ...

   "anymail",

   ...

]
ANYMAIL = {
# (exact settings here depend on your ESP...)
"MAILGUN_API_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 settings
SERVER_EMAIL = "your-server@example.com" # ditto (default from-email for Django errors) 3. Now the regular Django email functionswill send through your chosen ESP:
from django.core.mail import send_mail
send_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:
from django.core.mail import EmailMultiAlternatives
from anymail.message import attach_inline_image_file
msg = 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 = """

Please activate
your account

Optional Anymail extensions:

msg.metadata = {"user_id": "8675309", "experiment_variation": 1}
msg.tags = ["activation", "onboarding"]
msg.track_clicks = True

Send it:

msg.send()

See the full documentationfor more features and options, including receiving messages and tracking sent message status.