nodemailer-sendgrid-transport-categories

SendGrid transport for Nodemailer with categories support

Usage no npm install needed!

<script type="module">
  import nodemailerSendgridTransportCategories from 'https://cdn.skypack.dev/nodemailer-sendgrid-transport-categories';
</script>

README

nodemailer-sendgrid-transport

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

BuildStatus NPM version

Usage

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 https://sendgrid.com/docs/Classroom/Send/api_keys.html
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: ['joe@foo.com', 'mike@bar.com'],
    from: 'roger@tacos.com',
    subject: 'Hi there',
    text: 'Awesome sauce',
    html: '<b>Awesome sauce</b>'
};

mailer.sendMail(email, function(err, res) {
    if (err) { 
        console.log(err) 
    }
    console.log(res);
});

Deploying

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

License

Licensed under the MIT License.