Email management

How to Send Transactional Emails with Postmark API in Node.js? (w Codes and Examples)

Anjali Arya
January 19, 2024
Master sending transactional emails in Node.js using Postmark API. Comprehensive guide with codes and examples for seamless integration. Optimize your email workflow now with SuprSend and Postmark API in Node.
TABLE OF CONTENTS

This guide explores the process of establishing a programmatic Node.js-based transactional email delivery system using Postmark's transactional email API, shedding light on potential challenges and offering insights into optimizing this crucial aspect of communication. 

Prerequisites

Before delving into the hands-on tutorial, ensure you meet the following prerequisites:

  1. General familiarity with JavaScript and Node.js.
  2. Understanding of the async/await syntax in JavaScript.
  3. Proficiency in using the node command in the command line.
  4. Awareness of Express.js functionality and how middlewares operate in Express.js.

Now, let's proceed with setting up Postmark node.js for email sending. Let's dive in.

How to Send Emails with Nodejs and Postmark API?

To send transactional emails using Postmark Node.js, the initial step is to register for a free Postmark account. Follow their step-by-step email API integration guide outlined below.

Register and Generate an API Key on Postmark

  1. Begin by registering for a free Postmark account using a valid email address and a password (minimum 16 characters).
  2. After registration and email verification, navigate to your Postmark account and create a new server.
  3. Generate the API key from your server settings. Copy and securely store the API key for future use.

Setting Up a Node.js Script to Send Emails with Postmark

To initiate a new Node.js application using npm, execute the following commands:

  
   npm init -y
        
    

The `-y` flag will set default values. Next, set the API key created in the `postmark.env` file, and ensure it's added to `.gitignore`:

  
   echo "export POSTMARK_API_KEY='YOUR_API_KEY'" > postmark.env && echo "postmark.env" >> .gitignore && source ./postmark.env
        
    

Ensure to replace `YOUR_API_KEY` with the generated API key from the previous step. Afterward, install the `@postmark` npm package:

  
   npm i --save postmark
        
    

This command adds the latest version of the package to `package.json` and installs it locally in the `node_modules` folder.

Now, let's write code to test sending emails with Postmark:

  
      const postmark = require('postmark');
      const client = new postmark.Client(process.env.POSTMARK_API_KEY);

      function getMessage() {
        const body = 'This is a test email using Postmark from Node.js';
        return {
          To: 'you@domain.com',
          From: 'verifiedemail@previousstep.com',
          Subject: 'Test email with Node.js and Postmark',
          TextBody: body,
          HtmlBody: `${body}`,
        };
      }

      async function sendEmail() {
        try {
          await client.sendEmail(getMessage());
          console.log('Test email sent successfully');
        } catch (error) {
          console.error('Error sending test email');
          console.error(error);
        }
      }

      (async () => {
        console.log('Sending test email');
        await sendEmail();
      })();
        
    

This code includes the `postmark` package, sets the API key, defines a function to create an email message, and another to send the email using the `send` method. The script is an ES8 async IIFE.

After running this script with `node send-test-email.js`, you should receive a test email in your inbox.

Creating an Order Confirmation Email API in Node.js Using Postmark

For a practical example, let's transform the script into an API using Express.js. Install Express.js:

  
    npm i --save express
        
    

Create two files: `index.js` for the web server and `email.js` for the email service. Here's the `index.js`:

  
    const express = require('express');
    const email = require('./email');

    const app = express();
    const port = 3000 || process.env.PORT;

    app.use(express.json());
    app.use(express.urlencoded({ extended: false }));

    app.get('/', (req, res) => {
      res.json({ message: 'alive' });
    });

    app.post('/api/email/order-confirmation', async (req, res, next) => {
      try {
        res.json(await email.sendOrderConfirmation(req.body));
      } catch (err) {
        next(err);
      }
    });

    app.use((err, req, res, next) => {
      const statusCode = err.statusCode || 500;
      console.error(err.message, err.stack);
      res.status(statusCode).json({ 'message': err.message });
      return;
    });

    app.listen(port, () => {
      console.log(`Example API listening at http://localhost:${port}`);
    });
        
    

This Express server sets up a route for a simple "alive" message at the root and an API endpoint for sending order confirmation emails. The error handling middleware is also included.

Now, let's examine the structure of our email.js file. I utilized the Stripo.email free plan to create a mock order confirmation email, incorporating their provided template. Below is our email.js file, which assembles the email and dispatches it through Postmark:

  
    const postmark = require('postmark');
    const client = new postmark.Client(process.env.POSTMARK_API_KEY);

    function getOrderConfirmationEmailHtml(customerName, orderNr) {
      // HTML template for the order confirmation email
      // (omitted for brevity due to its length)
    }

    function getMessage(emailParams) {
      return {
        To: emailParams.toEmail,
        From: 'geshan@yipl.com.np',
        Subject: 'We have got your order, you will receive it soon',
        TextBody: `Hey ${emailParams.name}, we have received your order ${emailParams.orderNr}. We will ship it soon`,
        HtmlBody: getOrderConfirmationEmailHtml(emailParams.name, emailParams.orderNr),
      };
    }

    async function sendOrderConfirmation(emailParams) {
      try {
        // Send the order confirmation email using Postmark
        await client.sendEmail(getMessage(emailParams));
        return { message: `Order confirmation email sent successfully for orderNr: ${emailParams.orderNr}` };
      } catch (error) {
        // Handle errors and log relevant information
        const message = `Error sending order confirmation email or orderNr: ${emailParams.orderNr}`;
        console.error(message);
        console.error(error);
        return { message };
      }
    }

    module.exports = {
      sendOrderConfirmation,
    };
        
    

Let's delve into the functionality of email.js:

  1. Integration with Postmark: The module begins by importing the Postmark mail module and setting the API key using `postmarkMail.setApiKey()`.
  2. Order Confirmation HTML Template: The `getOrderConfirmationEmailHtml` function holds the extensive HTML template for the order confirmation email. It dynamically incorporates the customer's name and order number.
  3. Assembling the Email Message: The `getMessage` function constructs the email message with details such as recipient, sender, subject, text, and HTML body. The HTML body is generated using the previously defined template.
  4. Sending the Order Confirmation Email: The `sendOrderConfirmation` function orchestrates the entire process. It calls the `send` method on the `postmarkMail` module, passing the parameters obtained from `getMessage`. Any errors are caught, logged, and an appropriate response is sent back.
  5. Module Export: Finally, only the `sendOrderConfirmation` function is exposed from this module.

Once both files are correctly set up, you can launch the server with `node index.js`. Testing the order confirmation email API can be done with a cURL command:

  
    curl -i -X POST -H 'Accept: application/json' \
        -H 'Content-type: application/json' http://localhost:3000/api/email/order-confirmation \
        --data '{"name":"YourName", "orderNr": "12344", "toEmail": "yourEmail@gmail.com"}'
        
    

A successful response should display a 200 status, and you should find the confirmation email in your inbox.

Congratulations! The fundamental order confirmation email functionality is operational. The HTML template, though lengthy, can be replaced using Postmark's Dynamic templates.

While the method described above is functional, it may have certain limitations, and that's where SuprSend can offer valuable enhancements:

  1. Scalability Challenges: For scaling the nodejs email sending task, two primary options are presented. One is utilizing a queue system like RabbitMQ, employing producers and consumers to handle messages efficiently. Alternatively, a serverless FaaS (function-as-a-service) approach, using platforms like AWS Lambda or Vercel, provides a low-maintenance scaling solution. The order placement logic can asynchronously call this API, ensuring scalability with minimal resource concerns. Further exploration into scalability, costs, and potential hosting options is encouraged. The current implementation may face challenges in handling a rapidly increasing number of orders. As the order volume grows, the synchronous nature of the nodejs email sending process might lead to potential bottlenecks, affecting overall system scalability.
  2. Limited Monitoring and Analytics: The existing solution may lack comprehensive monitoring and analytics capabilities, making it challenging to gather insights into email delivery performance, recipient engagement, and potential issues.
  3. Maintenance Overhead: Managing and maintaining the nodejs email sending infrastructure, including handling errors and ensuring deliverability, might require ongoing effort and expertise.
  4. Integration Complexity: Integrating and maintaining multiple components, such as the email template, Postmark, and error handling, could introduce complexities and potential points of failure.
  5. Cost Considerations: Depending on the email volume, the costs associated with using Postmark and managing the infrastructure may become a concern.

For all these challenges, you can use SuprSend as a possible parent email infrastructure coupled with your product in Node.js to get started with any email provider such as Postmark. You can install and integrate SuprSend Node SDK to set up your product email notification infrastructure. Save yourselves from multiple vendor API integrations and email configurations for lifetime with these 4 easy steps

SuprSend Communication flow
Written by:
Anjali Arya
Product & Analytics, SuprSend
ABOUT THE AUTHOR

What’s a Rich Text element?

The rich text element allows you to create and format headings, paragraphs, blockquotes, images, and video all in one place instead of having to add and format them individually. Just double-click and easily create content.

Static and dynamic content editing

A rich text element can be used with static or dynamic content. For static content, just drop it into any page and begin editing. For dynamic content, add a rich text field to any collection and then connect a rich text element to that field in the settings panel. Voila!

How to customize formatting for each rich text

Headings, paragraphs, blockquotes, figures, images, and figure captions can all be styled after a class is added to the rich text element using the "When inside of" nested selector system.

Implement a powerful stack for your notifications
By clicking “Accept All Cookies”, you agree to the storing of cookies on your device to enhance site navigation, analyze site usage, and assist in our marketing efforts. View our Privacy Policy for more information.