nodemailer-sparkpost-transport

nodemailer-sparkpost-transport

SparkPost transport for Nodemailer

Usage

Install

npm install nodemailer-sparkpost-transport

Create a Nodemailer transport object

var nodemailer = require('nodemailer');
var sparkPostTransport = require('nodemailer-sparkpost-transport');
var transporter = nodemailer.createTransport(sparkPostTransport(options))

where:

• options defines connection default transmission properties
  • sparkPostApiKey - SparkPost API Key. If not provided, it will use the SPARKPOST_API_KEY env var.
  • campaign_id - Name of the campaign (optional)
  • metadata - Transmission level metadata containing key/value pairs (optional)
  • options - JSON object in which transmission options are defined (optional)
  • substitution_data - Key/value pairs that are provided to the substitution engine (optional)

For more information, see the SparkPost API Documentation for Transmissions

Send a message

transport.sendMail({
  from: '[e-mail]',
  to: '[e-mail]',
  subject: 'Very important stuff',
  text: 'Plain text',
  html: 'Rich taggery'
}, function(err, info) {
  if (err) {
    console.log('Error: ' + err);
  } else {
    console.log('Success: ' + info);
});

Read more about Nodemailer's sendMail() method here.

Additional Options

The SparkPost Nodemailer transport also supports a few SparkPost-specific sendMail() options in both the transport constructor and the 'sendMail()` method.

Note: sendMail() options override their constructor counterparts:

• options
  • campaign_id - Overrides for constructor option
  • metadata - Override for constructor option
  • options - Override for constructor option
  • substitution_data - Override for constructor option

Changelog

[1.0.0] - 2016/07/26

• #7 Implemented the Nodemailer API (@ewandennis)