Fastify nodemailer plugin

Downloads in past


2675.0.04 years ago7 years agoMinified + gzip package size for fastify-nodemailer in KB


js-standard-style Build Status Known Vulnerabilities Coverage Status npm (scoped) npm
Fastify nodemailer plugin, with this you can share the same nodemailer transporter in every part of your server.
Under the hood the it wraps nodemailer transporter and the options that you pass to register will be passed to the transporter. For configuration/usage details please check the nodemailer documentation.


npm i fastify-nodemailer --save


The plugin supports the following Fastify and Nodemailer versions. Please refer to corresponding branch in PR and issues.
version | branch | fastify | nodemailer | End of support --------|--------|---------|------------|---------------
1.x | 1.x | 1.x | 4.x | EOL
2.x | 2.x | 2.x | 4.x | TBD
3.x | master | 2.x | 5.x | Deprecated 4.x | 4.x | 2.x | 6.x | TBD 5.x | master | 3.x | 6.x | TBD


Add it to you project with register and you are done! You can access the transporter via fastify.nodemailer and sendMail() via fastify.nodemailer.sendMail().
const fastify = require('fastify')()

fastify.register(require('fastify-nodemailer'), {
  pool: true,
  host: '',
  port: 465,
  secure: true, // use TLS
  auth: {
      user: 'username',
      pass: 'password'

fastify.get('/sendmail/:email', (req, reply, next) => {
  let { nodemailer } = fastify
  let recipient =

    from: '',
    to: recipient,
    subject: 'foo',
    text: 'bar'
  }, (err, info) => {
    if (err) next(err)
      messageId: info.messageId

fastify.listen(3000, err => {
  if (err) throw err
  console.log(`server listening on ${fastify.server.address().port}`)

Custom transports

By default, passing an object as options to the plugin will configure nodemailer's main transport (SMTP).
If you need a custom transport, simply initialize the transport, and pass it to the plugin instead of an options object. For example, using the nodemailer-sparkpost-transport:
const fastify = require('fastify')()

const sparkPostTransport = require('nodemailer-sparkpost-transport')

const sparkPostTransportOptions = {
  sparkPostApiKey: 'MY_API_KEY'

fastify.register(require('fastify-nodemailer'), sparkPostTransport(sparkPostTransportOptions))

// or

const sparkPostTransportInstance = sparkPostTransport(sparkPostTransportOptions)

fastify.register(require('fastify-nodemailer'), sparkPostTransportInstance)

Then, later:
fastify.get('/sendmail', (req, reply, next) => {

  const sendOptions = {
    content: {
      template_id: 'my_template_id',
      use_draft_template: false
    "recipients": [
        "address": {
          "email": "",
          "name": "John Doe"
        "substitution_data": {
          username: "John Doe"

  fastify.nodemailer.sendMail(sendOptions, (err, info) => {
    if (err) next(err)
      messageId: info.messageId


Multiple transports

Since fastify-nodemailer fully supports Fastify's built-in encapsulation feature, all you need to do is register this plugin with your custom transporter and the corresponding route in a new context.


Licensed under MIT.