Email notifications have become an integral part of our systems. Common use-cases include sending reports, notifying build success, system failure events, etc. This tutorial demonstrates a solution using Google Cloud Functions to send emails using Sendgrid.
Goals
- Scalable
- Ease of content modification
- Reliable delivery
Setup
A sender will provide the trigger a cloud function with params. The cloud function will make a call to Sendgrid which in turn will send emails to the receiver.
Setting up a Sendgrid account
You can Sign up for a Sendgrid Account to manage our details. It offers a generous free plan which is enough for our demo. Choose the create single sender option, in case you want to use your own domain the instructions can be found here.
You’ll receive an email for sender confirmation as configured, click on Verify Single Sender.
Obtaining an API key
Sending emails via APIs is the recommended way for apps rather than SMTP. So, we’ll use the Web APIs which will be called by the SDKs. Let’s get the API Key for our account.
Great, now let’s start coding!
Library function for Sendgrid
Let’s create a library that will enable us to send emails via Sendgrid. This way our code is decoupled and can be used by a simple library import.
Install the Sendgrid SDK via npm.
# install Sendgrid dependency
npm install --save @sendgrid/mail
Now let’s write a library that abstracts the SDK calls of Sendgrid.
Let’s test the lib code with our API Key.
Great! now we have a working library code, let’s use it in our cloud function.
Cloud function
Let’s create a simple cloud function that uses this library and sends an email.
Here, we have configured the API Key as an env variable, thus we need to make sure that it is available at runtime. Make sure that the lib code is also part of the deployment, else it will throw an error.
Sample command to deploy the cloud function
gcloud functions deploy sendgridDemo --trigger-http --entry-point=sendgridCF \
--region=us-central1 --runtime=nodejs10 --set-env-vars API_KEY='123'
Once deployed make sure to change the env variable value with the actual Sendgrid API Key.
Testing
Visit the Cloud Function’s Testing tab to test the function. Just click on ‘TEST THE FUNCTION’ to trigger the function.
Now let’s verify in our mailbox. Sometimes the email appears in spam, so be sure to check there if not received.
You may wonder that why is ‘Sample Text’ not visible? It seems that ‘text’ is a fallback in the event the email client does not support HTML emails.
Thus we can send emails programmatically in a serverless way. Note that because we worked in a library structure, we can extend this and have a similar setup for AWS Lambda.
All the code samples can be found in our git repository
thefellowcoder / cloud-functions
Code samples for cloud functions
cloud-functions
Code samples for cloud functions
Hope you found this tutorial helpful.
Let us know your thoughts in the comment section below.
Top comments (0)