How to Send Email Using SendGrid in Node js

Spread the love


Sending emails is a crucial part of many web applications, whether it’s for user registration, password resets, or notifications. Using a reliable email service like SendGrid can simplify this process. In this guide, we will explore how to send email using SendGrid in Node js. By the end, you’ll have a clear understanding of how to integrate SendGrid into your Node.js application to handle all your email needs.

Node Js Tutorial: Complete Node js Tutorial: Setup, Development, and Deployment

Setting Up SendGrid Account

To begin using SendGrid in Node js, the first step is to set up a SendGrid account and generate an API key.

  1. Creating a SendGrid Account
    • Go to the SendGrid website.
    • Click on “Sign Up for Free” and follow the prompts to create an account.
    • Once your account is created, navigate to the SendGrid Dashboard.
  2. Generating an API Key
    • In the SendGrid Dashboard, go to “Settings” and select “API Keys.”
    • Click on “Create API Key.”
    • Give your API key a name, set the permissions to “Full Access,” and click “Create & View.”
    • Copy the API key and store it securely. You will need this key to authenticate your Node.js application with SendGrid.

By following these steps, you’ve successfully set up a SendGrid account and generated an API key to use SendGrid in Node js.

Also, Read: How to Use Cron Job in Node js

Installing Required Packages

With your SendGrid account ready, the next step is to set up a Node.js project and install the necessary packages to use SendGrid in Node js.

  1. Setting Up a Node.js Project
    • Create a new directory for your project and navigate into it:
mkdir sendgrid-nodejs-example
cd sendgrid-nodejs-example
  • Initialize a new Node.js project:
npm init -y

2. Installing SendGrid’s Node.js Library

  • Install the SendGrid package using npm:
npm install @sendgrid/mail

By completing these steps, you’ve set up a Node.js project and installed the necessary package to use SendGrid in Node js.

Configuring SendGrid in Node js

Next, we’ll configure SendGrid in your Node.js application to start sending emails.

  1. Importing and Configuring SendGrid
    • Create a new file named sendEmail.js and add the following code:
const sgMail = require('@sendgrid/mail');

2. Sending a Basic Email

  • Add the following code to sendEmail.js to send a basic email:
const msg = {
  to: '',
  from: '',
  subject: 'Sending with SendGrid is Fun',
  text: 'and easy to do anywhere, even with Node.js',
  html: '<strong>and easy to do anywhere, even with Node.js</strong>',

  .then(() => {
    console.log('Email sent');
  .catch((error) => {

Replace 'YOUR_SENDGRID_API_KEY' with the API key you generated earlier, and update the to and from fields with the appropriate email addresses.

By following these steps, you’ve configured SendGrid in Node js and are ready to send emails.

Handling Errors and Responses

Handling errors and responses is an important part of working with SendGrid in Node js to ensure your emails are sent successfully.

  1. Handling Errors
    • Modify the error handling in your sendEmail.js file to provide more detailed error information:
  .then(() => {
    console.log('Email sent');
  .catch((error) => {
    console.error('Error sending email:', error);
    if (error.response) {
      console.error('Response error:', error.response.body);

By adding this error handling, you’ll be able to troubleshoot any issues that arise when sending emails using SendGrid in Node js.

Also, Read: How to Integrate Stripe Payment Gateway in Node js

Advanced Email Features with SendGrid in Node js

SendGrid offers advanced features that can enhance your email capabilities. Let’s explore some of these features.

  1. Sending HTML Emails
    • Update the html field in your msg object to include more complex HTML content:
const msg = {
  to: '',
  from: '',
  subject: 'Sending HTML Email with SendGrid',
  html: '<h1>Welcome to SendGrid</h1><p>This is a <strong>HTML</strong> email.</p>',

2. Attaching Files to Emails

  • Add attachments to your email by including the attachments field in the msg object:
const fs = require('fs');
const path = require('path');

const attachment = fs.readFileSync(path.join(__dirname, 'file.txt')).toString('base64');

const msg = {
  to: '',
  from: '',
  subject: 'Sending Attachments with SendGrid',
  text: 'Check out this attachment!',
  attachments: [
      content: attachment,
      filename: 'file.txt',
      type: 'text/plain',
      disposition: 'attachment',

3. Including Dynamic Content in Emails

  • Use dynamic content to personalize your emails:
const msg = {
  to: '',
  from: '',
  subject: 'Personalized Email with SendGrid',
  html: '<h1>Hello, {{name}}!</h1><p>Thank you for joining us.</p>',
  substitutions: {
    name: 'John Doe',

These advanced features demonstrate the flexibility and power of using SendGrid in Node js to enhance your email communication.


In this guide, we’ve covered how to send email using SendGrid in Node js, from setting up your SendGrid account to configuring your Node.js application and sending both basic and advanced emails. By leveraging the power of SendGrid, you can ensure reliable and efficient email communication in your web applications. Explore further features of SendGrid to unlock even more capabilities for your projects.

Leave a Comment