sendgrid-web

Easily send emails with sendgrid and node.js

npm install sendgrid-web
1 downloads in the last day
4 downloads in the last week
43 downloads in the last month

sendgrid-web

Send emails with sendgrid and node.js! This sendgrid module (there are others) uses their JSON web API and the request module.

Install:

npm install sendgrid-web

Example:

    var Sendgrid = require("sendgrid-web");

    var sendgrid = new Sendgrid({
      user: "josh.holbrook@gmail.com",
      key: "oh, like you need to know."
    });

    sendgrid.send({
      to: 'josh.holbrook@gmail.com',
      from: 'josh.holbrook@gmail.com',
      subject: 'Hello world!',
      html: '<h1>Hello world!</h1>'
    }, function (err) {
      if (err) {
        console.log(err);
      } else {
        console.log("Success.");
      }
    });

Usage:

new Sendgrid(credentials)

This constructor creates a new sendgrid object. The "credentials" object should contain:

  • user: Your sendgrid username
  • key: Your sendgrid API key/password

sendgrid.send(options, cb)

Sends an email. Options are the same as those of the sendgrid json web api. Common ones include:

  • to: The recipient of the email.
  • from: The email address to reply back to.
  • subject: The subject of the email.
  • html: The body of the email, if it's intended to be treated like html.
  • text: The body of the email, if it's intended to be treated like plaintext.

Tests:

In order to run the tests, sendgrid needs a user, api key, and email addresses to send to and from. Before running these tests, open ./test/config-template.json, edit it to contain your credentials and information, and save it as ./test/config.json.

Then, you may run the tests with nodeunit:

nodeunit test/*.js

Author: Joshua Holbrook

npm loves you