The easiest way to send emails with Django (using SES from AWS)

Do you want to send emails in your application? Notifications, newsletters, promotions, there are so many reasons to send emails. After reading this article you’ll be able to send any sorts of emails from your Django application. There are many ways you can send emails using different email sending services. But in this guide, I’ll cover one of the most popular services, SES, or Simple Email Service. It has been developed by Amazon and can be used for free for up to 62000 emails per month. To work with SES we’ll use library. It is very easy to set up and use. [django-ses](https://github.com/django-ses/django-ses) But before we can start you need to… Sign up on AWS If you don’t already have an AWS account you need to get one. You simply won’t be able to use SES without it. To sign up you need to go to . the AWS sign up page Setting up I’m assuming you already have a Django project. To install library you need to run the following command django-ses pip install django-ses Once the library is installed you need to tell Django to use this library as email backend by adding the following line to your settings.py EMAIL_BACKEND = 'django_ses.SESBackend' Then you need to get credentials for SES Go to AWS Choose IAM service Add user Choose a name for the user and “Programmatic access” type (to get access key ID and secret access key) Attach permission AmazonSESFullAccess Create user After that, you should see “Access key ID” and “Secret access key”. Add them to like that settings.py AWS_ACCESS_KEY_ID = 'YOUR-ACCESS-KEY-ID'AWS_SECRET_ACCESS_KEY = 'YOUR-SECRET-ACCESS-KEY' Sending an email Now that we have all the credentials in place, we can send an email. We can do this using Django core functionality ( to be more specific). [django.core.mail.send_mail](https://docs.djangoproject.com/en/2.1/topics/email/) from django.core.mail import send_mailsend_mail('Subject here','Here is the message.',' ',[' ']) from@example.com to@example.com And this email should be sent using SES. So let’s jump into Django’s shell and try it out. python manage.py shell>>> from django.core.mail import send_mail>>> send_mail(... 'Subject here',... 'Here is the message.',... ' ',... [' ']...)boto.ses.exceptions.SESAddressNotVerifiedError: SESAddressNotVerifiedError: 400 Email address is not verified. Sender MessageRejected Email address is not verified. The following identities failed the check in region US-EAST-1: 3966220a-3c6c-11e9-909d-889357e40867 from@example.com to@example.com http://ses.amazonaws.com/doc/2010-12-01/ from@example.com Oh no! We got an error… Who would’ve thought that we couldn’t send emails from . Let’s fix this. from@example.com Sending emails from your personal email address To begin with, we can send an email from your personal email address. This should be pretty acceptable if you’re building an MVP. If you don’t want for everyone to see your personal email, you can create a separate email address for your application like . If people will start blocking your email for some reason, it will not affect your personal email health. your.application@gmail.com To send emails from your email address you need to Go to AWS Choose SES service Go to “Email Addresses” tab Click “Verify a New Email Address” Enter your email address of choice Go to the inbox for the email you’ve specified Confirm that you want to use your email in SES Once you’re done, you should be able to send an email from the Django shell >>>send_mail(... 'Subject here',... 'Here is the message.',... ' ',... [' ']...)1 your.application@gmail.com your.email.address+to.test@example.com After that, you should receive an email You might’ve noticed a number that has been returned by the method. This is the number of successfully sent emails, which in our case was 1. send_mail If we try to send an email to some address and it will fail then the failed email will not get counted >>> send_mail(... 'Subject here',... 'Here is the message.',... ' ',... [' ', ' ']... )1 your.application@gmail.com your.email.address+to.test@example.com not.existing.email.for.real.asdvsrg@gmail.com This call returned 1 because it could not send an email to the second address ( ) because it does not exist. I just made it up. send_mail not.existing.email.for.real.asdvsrg@gmail.com Sending emails from a custom domain Once your MVP is working and you have a domain for your application it’s time to send emails from this domain. To do this you need to add this domain to SES Go to AWS Choose SES service Go to the “Domains” tab Click “Verify a new domain” If you already have your domain on AWS Route53 then you just click through and your domain will be ready. If you have your domain set up somewhere else you need to follow specified instructions. Once you do follow the instructions correctly, you should see green verified status and the domain should be ready for sending emails via SES. We can go back to our Django shell and test sending emails from the new and shiny domain >>>send_mail(... 'Subject here',... 'Here is the message.',... ' ',... [' ']...)1 hello@yourdomain.com your.email.address+to.test@example.com Here’s your email Pretty neat, right? But it could be even more pretty… Custom name in the email Have you ever noticed a pretty email name? Something like this It even includes a link to unsubscribe. You can be so cool too. This is very easy. You just need to modify the sender name. Add a desired name in the beginning in double quotes and an email address the email will be sent from in the end in like this . <> ”Desired name” >>>send_mail(... 'Subject here',... 'Here is the message.',... '"Hello, you" ',... [' ']...)1 hello@yourdomain.com your.email.address+to.test@example.com Now you have a cool name too And it can be whatever you want it to. Conclusion Now you should know how to set up library django-ses use it to send emails set up emails in SES set up domains in SES make email sender info prettier This is the sixth part of a series of articles about the . Stay tuned for part 7. You can find , as well as my other projects, on my . Leave your comments down below and follow me if you liked this article. MuN the code of this project GitHub page Originally published at https://kholinlabs.com/the-easiest-way-to-send-emails-with-django on March 4, 2019.