Leia a versão em português no README.pt-br.md.

This is a NPM library to make usage of Locaweb transactional email service API with NodeJS.

WARNING: if you wish to send email using the SMTP protocol, instead of the REST API, use a SMTP library such as Nodemailer to send your messages.

Install it as usual, with NPM package manager by typing:

npm i smtp-locaweb-nodejs

After that, you must create a .env file on the root folder of your application with your account's API token, just like show below:

TOKEN=yourAccountToken

No spaces are allowed. The token can be found by accessing the product's dashboard.

Later, just require the package on your application:

var locaweb = require('smtp-locaweb-nodejs');

You can create a new email object involking the Email constructor and using the following methods to populate it:

var email = new locaweb.Email();

email.addTo('[email protected]');
email.addSubject('Email title!!!');
email.addFrom('[email protected]');
email.addBody('A cool and useful content.');
email.addCc('[email protected]');
email.addBcc('[email protected]');
email.addHeaders({x-source: api});

locaweb.sendMail(email);

Another possible way is passing an object to the constructor. The advantage to this strategy is that you can pass multiples recipients, CCs, BCCs in an array:

message = {
    to: ['[email protected]', '[email protected]', '[email protected]'],
    subject: 'Email title!!!',
    from: '[email protected]',
    body: 'A cool and useful content.',
    cc: ['[email protected]']
}

var email = new locaweb.Email(message);

locaweb.sendMail(email);

Only the first 4 attributes are mandatory, the others are all optional. For more in-depth information, see the official documentation at http://developer.locaweb.com.br/documentacoes/smtp.