notifications-node-client

What is notifications-node-client?

The notifications-node-client is an npm package designed to interact with the GOV.UK Notify service, which allows you to send emails, text messages, and letters. This package provides a simple interface to integrate these notification services into your Node.js applications.

What are notifications-node-client's main functionalities?

Send Email

This feature allows you to send an email using a predefined template. You need to provide the template ID, recipient's email address, and any personalisation fields required by the template.

const NotifyClient = require('notifications-node-client').NotifyClient;
const notifyClient = new NotifyClient('your-api-key');

notifyClient.sendEmail('template-id', '[e-mail]', {
  personalisation: {
    name: 'John Doe',
    reference: '12345'
  },
  reference: 'your-reference'
}).then(response => console.log(response)).catch(err => console.error(err));

Send SMS

This feature allows you to send an SMS using a predefined template. You need to provide the template ID, recipient's phone number, and any personalisation fields required by the template.

const NotifyClient = require('notifications-node-client').NotifyClient;
const notifyClient = new NotifyClient('your-api-key');

notifyClient.sendSms('template-id', '07123456789', {
  personalisation: {
    name: 'John Doe',
    reference: '12345'
  },
  reference: 'your-reference'
}).then(response => console.log(response)).catch(err => console.error(err));

Send Letter

This feature allows you to send a letter using a predefined template. You need to provide the template ID and the recipient's address details.

const NotifyClient = require('notifications-node-client').NotifyClient;
const notifyClient = new NotifyClient('your-api-key');

notifyClient.sendLetter('template-id', {
  personalisation: {
    address_line_1: 'John Doe',
    address_line_2: '123 Main Street',
    postcode: 'AB1 2CD'
  },
  reference: 'your-reference'
}).then(response => console.log(response)).catch(err => console.error(err));

Other packages similar to notifications-node-client

nodemailer

Nodemailer is a module for Node.js applications to allow easy email sending. Unlike notifications-node-client, which is specific to the GOV.UK Notify service, Nodemailer is a more general-purpose email sending library that supports various transport methods including SMTP, AWS SES, and more.

twilio

Twilio is a comprehensive communication API that allows you to send SMS, make voice calls, and perform other communication tasks. It is more versatile compared to notifications-node-client, which is focused on the GOV.UK Notify service. Twilio supports a wide range of communication channels and is used globally.

sendgrid

SendGrid is a cloud-based service that provides email delivery and marketing campaigns. It offers a robust API for sending emails, managing lists, and tracking email performance. Unlike notifications-node-client, which is limited to the GOV.UK Notify service, SendGrid provides a broader range of email-related functionalities.

README

GOV.UK Notify Node.js client

Use this client to send emails, text messages and letters using the GOV.UK Notify API.

Useful links:

• Documentation
• NPM package
• Changelog
• Contributing to this client

Changelog

8.1.0 - 2024-05-09

• The sendEmail function can now be passed oneClickUnsubscribeURL as an optional argument.