Send Email (via Mandrill, with promises)

A simple utility function without any dependencies that sends email via Mandrill's REST API and returns a Promise.

Why use this?

While Mandrill provides their own NodeJS SDK, it is 3000 lines of code, includes dozens of unrelated functions, and is callback-based.

Other public utilities (e.g. mandrill-send) are callback-based and have dependencies that must be updated to remain secure and stable. Dependencies are hell.

mandrill-send-promise is promise-based, has 100% test coverage, and has no dependencies.

Installation

Run npm install mandrill-send-promise or yarn add mandrill-send-promise.

Setup

Import mandrill-send-promise into the file where you want to send your email.

const sendEmail = require('mandrill-send-promise')('API_KEY');

Usage

Call that sendEmail function with an object parameter that includes all required fields.

sendEmail(
  {
    from_email: "noreply@example.com",
    from_name: "From Name",
    to_email: "to@example.com",
    to_name: "To Name",
    subject: "Hello from Squad!",
    text: 'Hello! This is a test email.',
    tags: ['example', 'hello']
  }
);

Parameters

Required

from_email (string) - The email address you want listed as 'from'. For this to work, you need to setup a sending domain on Mandrill.
from_name (string) - Your name or your company's name.
to_email (string) - The email address of your user.
to_name (string) - The name of your user.
subject (string) - The email subject
text (string) - Tags for filtering sent emails within Mandrill

Optional

reply_to (string) - If you want users to reply to a different email address than what is listed as the "from" address.
html (string) - HTML for a rich email

Examples

To run the example, open your terminal, cd into the examples folder and run node -e "require('./sendEmail').sendExampleEmail(MANDRILL_API_KEY)" where "MANDRILL_API_KEY" is your own test api key from Mandrill.

Running Tests

To run the jest tests, you need to add an environment variable named mandrillAPIKey with your own test key from Mandrill.