mailer setup
Getting SendGrid
SendGrid is a good choice for our example because it has a free tier, and a well-documented API that we can creat a client for as well as a webhook that we can provide a service for.
As a client, we send email requests to SendGrid. SendGrid will send our emails to customers and will call our webhook service with additional information about how the recipient of the email reacted to the email. Whether the email bounced or was received, whether the recipient opened the email or clicked on a link that we provided in the email.
What you'll need
In order to run the code for ourselves we need to
Create a SendGrid account
Create a new account by visiting the SendGrid site and signing up. We won't spend a lot of time setting up the account - the instructions provided by SendGrid are easy to understand.
Read the excellent SendGrid documentation to get your account set up
Create an API key
Once we've created our account we'll need to create the API key that we'll use to authenticate with SendGrid. This process is documented in the docs here:
Log into your SendGrid account and add the API key per the instructions provided there
Use the API Key
The API Key needs to be inserted as a value in the SendGridMailer.
There are a few ways to do this. Setting up spring boot configurations is beyond the scope of this walkthrough, but generally:
place it into the application.properties resource file
declare it as an Environment variable
on the command line, or
in an ".env" file
Run the service
Make sure the proper headers are set ! Content-type should be 'application/json'
Last updated
