Wednesday, 16 August, 2023 UTC
Summary
So you're building a Node.js app and you need to programmatically send some emails, including with CC and BCC fields. The Twilio SendGrid API for sending email is a great solution to this problem.
If you have a SendGrid account and an API key set as an environment variable, here is all the code you need to send an email with CC and BCC fields in JavaScript:
const sendgridMail = require('@sendgrid/mail'); sendgridMail.setApiKey(process.env.SENDGRID_API_KEY); const email = { to: 'TO_EMAIL_ADDRESS', from: 'FROM_EMAIL_ADDRESS', cc: ['FIRST_CC_EMAIL', 'SECOND_CC_EMAIL'], bcc: ['FIRST_BCC_EMAIL', 'SECOND_BCC_EMAIL'], subject: 'Sending with SendGrid is Fun', html: '<strong>and easy to do anywhere, even with Node.js</strong>', }; sendgridMail.send(email); Let's walk through how to get this running step by step.
Developer Environment Setup Make sure we have the right software installed that we'll need to use for the rest of this post. Throughout this post you will need:
- Node.js and npm installed (do this first if you haven't already)
- A free SendGrid account
- The SendGrid Node library
Here is a good guide to follow on setting up your development environment if you are going to be doing more web development with Node.js.
Sign up for SendGrid and create an API key The first thing you need to do is create a SendGrid account. You can choose the free tier for the purpose of this tutorial. Once you have an account, you need to create an API key as seen in this screenshot. You can name it whatever you want, but once it is created make sure you save it before moving on!
A good way to save this API key is to set it as an environment variable that you can access from your Python code in order to avoid writing it directly in your code. Set the value of the
Sending an Email using CC and BCC with Node.js SENDGRID_API_KEY environment variable to be the API key from your SendGrid account. Here's a useful tutorial if you need help setting environment variables. We will use this later on.Now that you have a SendGrid account and an API key, you're ready to dive into some code and send emails! Start by opening your terminal and navigating to the directory where you want your project to live and running the following command to initiate a
package.json file for npm to install dependencies:npm init --yes Now install the SendGrid helper library for Node:
npm install @sendgrid/mail Now create a file called
index.js in this directory and add the following code to it:const sendgridMail = require('@sendgrid/mail'); sendgridMail.setApiKey(process.env.SENDGRID_API_KEY); const email = { to: 'TO_EMAIL_ADDRESS', from: 'FROM_EMAIL_ADDRESS', cc: ['FIRST_CC_EMAIL', 'SECOND_CC_EMAIL'], bcc: ['FIRST_BCC_EMAIL', 'SECOND_BCC_EMAIL'], subject: 'Sending with SendGrid is Fun', html: '<strong>and easy to do anywhere, even with Node.js</strong>', }; sendgridMail.send(email); Before running this code, make sure you have the
SENDGRID_API_KEY environment variable set, and remember to replace the email values with the addresses you want to send emails to and from.Finally, in your terminal run the following command to run this code to send yourself, and whoever you cc'ed or bcc'ed, an email:
node index.js Check your inbox and you should see something like this!
What next? You just successfully sent your first email using Python, but what if you want to do more than just send emails? You can also process and respond to incoming emails using SendGrid's Inbound Email Parse Webhook. You can also check out the SendGrid docs for a ton of other cool features and uses.
I’m looking forward to seeing what you build. Feel free to reach out and share your experiences or ask any questions.
- Email: [email protected]
- Twitter: @Sagnewshreds
- Github: Sagnew
- Twitch (streaming live code): Sagnewshreds