Skip to content
SendGrid transport for Nodemailer
Find file
Latest commit 51d6c2e Mar 22, 2016 @thinkingserious thinkingserious Create LICENSE.txt


This module is a transport plugin for Nodemailer that makes it possible to send through SendGrid's Web API!

BuildStatus NPM version


Install via npm.

npm install nodemailer-sendgrid-transport

Require the module and initialize it with your SendGrid credentials.

var nodemailer = require('nodemailer');
var sgTransport = require('nodemailer-sendgrid-transport');

// api key
var options = {
    auth: {
        api_key: 'SENDGRID_APIKEY'

// or

// username + password
var options = {
    auth: {
        api_user: 'SENDGRID_USERNAME',
        api_key: 'SENDGRID_PASSWORD'

var mailer = nodemailer.createTransport(sgTransport(options));

Note: We suggest storing your SendGrid username and password as enviroment variables.

Create an email and send it off!

var email = {
    to: ['', ''],
    from: '',
    subject: 'Hi there',
    text: 'Awesome sauce',
    html: '<b>Awesome sauce</b>'

mailer.sendMail(email, function(err, res) {
    if (err) { 


  • Confirm tests pass
  • Bump the version in, package.json, test/sendgrid-transport-test.js
  • Update
  • Confirm tests pass
  • Commit Version bump vX.X.X
  • npm publish
  • Push changes to GitHub
  • Release tag on GitHub vX.X.X


Licensed under the MIT License.

Something went wrong with that request. Please try again.