NODEMAILER :: NODEMAILER1 NODEMAILER2 USAGE3 MESSAGE CONFIGURATION4 SMTP TRANSPORT5 OTHER TRANSPORTS6 PLUGINS Nodemailer. Nodemailer is a module for Node.js applications to allow easy as cake email sending. The project got started back in 2010 when there was no sane option to send email messages, today it is the solution most Node.js users turn to by default. SMTP TRANSPORT :: NODEMAILER SMTP transport. SMTP is the main transport in Nodemailer for delivering messages. SMTP is also the protocol used between different email hosts, so its truly universal. Almost every email delivery provider supports SMTP based sending, even if they mainly push their API based sending. APIs might have more features but using these also

means

TESTING SMTP :: NODEMAILER Nodemailer is a module for Node.js to send emails. Testing SMTP. When building complex applications then sooner or later you end up in a situation where you need to send emails from your application in test environment but do not want to accidentally spam anyone. SENDMAIL TRANSPORT :: NODEMAILER Nodemailer is a module for Node.js to send emails. Sendmail transport. Sendmail transport pipes the generated RFC822 message to the standard input of the sendmail command, so it’s the same thing what the mail() function in PHP does.. To use Sendmail transport, set sendmail in Nodemailer transport options to true.. The additional options to use with this transport are the following:

WELL-KNOWN SERVICES

Well-known services. Nodemailer knows SMTP connection details for several well-known providers. If your provider is listed here you do not need to set the connection details yourself (you can if you want it though) for the transporter object, providing service name is already good enough. DKIM - NODEMAILER :: NODEMAILER Nodemailer is a module for Node.js to send emails. DKIM signing. Nodemailer is able to sign all messages with DKIM keys. This means calculating a signature for the message and adding it as an additional header (or headers, if you use multiple keys) to the message. SMTP CONNECTION :: NODEMAILER Where. callback is the function to run once the connection is established. The function is added as a listener to the ‘connect’ event. After the connect event the connection has the following properties:. connection.secure - if true then the connection uses a TLS socket, otherwise it is using a cleartext socket. Connection can start out as cleartext but if available (or requireTLS is set OAUTH2 :: NODEMAILER OAuth2. OAuth2 allows your application to store and use authentication tokens instead of actual login credentials. This is great for security as tokens or valid only for specific actions and can be easily revoked thus, once stolen, can’t to as much harm as actual account

credentials.

TEMPLATING – NODEMAILER NB! these docs do not work with latest email-templates module See the current docs for email-templates here Nodemailer allows to use simple built-in templating or alternatively external renderers f SETUP SMTP – NODEMAILER SMTP connection is opened directly to recipients MX server, skipping any local SMTP relays. useful when you do not have a SMTP relay to use. Riskier though since messages from untrusted servers usually end up in the Spam folder. All SMTP connections allow to use proxies for making connections. Read about proxy support in Nodemailer from here. NODEMAILER :: NODEMAILER1 NODEMAILER2 USAGE3 MESSAGE CONFIGURATION4 SMTP TRANSPORT5 OTHER TRANSPORTS6 PLUGINS Nodemailer. Nodemailer is a module for Node.js applications to allow easy as cake email sending. The project got started back in 2010 when there was no sane option to send email messages, today it is the solution most Node.js users turn to by default. SMTP TRANSPORT :: NODEMAILER SMTP transport. SMTP is the main transport in Nodemailer for delivering messages. SMTP is also the protocol used between different email hosts, so its truly universal. Almost every email delivery provider supports SMTP based sending, even if they mainly push their API based sending. APIs might have more features but using these also

means

TESTING SMTP :: NODEMAILER Nodemailer is a module for Node.js to send emails. Testing SMTP. When building complex applications then sooner or later you end up in a situation where you need to send emails from your application in test environment but do not want to accidentally spam anyone. SENDMAIL TRANSPORT :: NODEMAILER Nodemailer is a module for Node.js to send emails. Sendmail transport. Sendmail transport pipes the generated RFC822 message to the standard input of the sendmail command, so it’s the same thing what the mail() function in PHP does.. To use Sendmail transport, set sendmail in Nodemailer transport options to true.. The additional options to use with this transport are the following:

WELL-KNOWN SERVICES

Well-known services. Nodemailer knows SMTP connection details for several well-known providers. If your provider is listed here you do not need to set the connection details yourself (you can if you want it though) for the transporter object, providing service name is already good enough. DKIM - NODEMAILER :: NODEMAILER Nodemailer is a module for Node.js to send emails. DKIM signing. Nodemailer is able to sign all messages with DKIM keys. This means calculating a signature for the message and adding it as an additional header (or headers, if you use multiple keys) to the message. SMTP CONNECTION :: NODEMAILER Where. callback is the function to run once the connection is established. The function is added as a listener to the ‘connect’ event. After the connect event the connection has the following properties:. connection.secure - if true then the connection uses a TLS socket, otherwise it is using a cleartext socket. Connection can start out as cleartext but if available (or requireTLS is set OAUTH2 :: NODEMAILER OAuth2. OAuth2 allows your application to store and use authentication tokens instead of actual login credentials. This is great for security as tokens or valid only for specific actions and can be easily revoked thus, once stolen, can’t to as much harm as actual account

credentials.

TEMPLATING – NODEMAILER NB! these docs do not work with latest email-templates module See the current docs for email-templates here Nodemailer allows to use simple built-in templating or alternatively external renderers f SETUP SMTP – NODEMAILER SMTP connection is opened directly to recipients MX server, skipping any local SMTP relays. useful when you do not have a SMTP relay to use. Riskier though since messages from untrusted servers usually end up in the Spam folder. All SMTP connections allow to use proxies for making connections. Read about proxy support in Nodemailer from here. PRICING - NODEMAILER Nodemailer is a module for Node.js to send emails. Pricing. Nodemailer can be purchased from Kreata OÜ. License fee (excluding VAT) for a 1 year license is $820.-.. Buy Nodemailer Subscription SENDMAIL TRANSPORT :: NODEMAILER Nodemailer is a module for Node.js to send emails. Sendmail transport. Sendmail transport pipes the generated RFC822 message to the standard input of the sendmail command, so it’s the same thing what the mail() function in PHP does.. To use Sendmail transport, set sendmail in Nodemailer transport options to true.. The additional options to use with this transport are the following: DKIM - NODEMAILER :: NODEMAILER Nodemailer is a module for Node.js to send emails. DKIM signing. Nodemailer is able to sign all messages with DKIM keys. This means calculating a signature for the message and adding it as an additional header (or headers, if you use multiple keys) to the message. MESSAGE CONFIGURATION :: NODEMAILER Message configuration. The following are the possible fields of an email message: Common fields. from - The email address of the sender. All email addresses can be plain ‘ ’ or formatted '“Sender Name” ', see Address object for details; to - Comma separated list or an array of recipients email addresses that will appear on the To: field SMTP SERVER :: NODEMAILER SMTP Server. Create SMTP and LMTP server instances on the fly. This is not a full-blown server application like Haraka but an easy way to add custom SMTP listeners to your app. This module is the successor for the server part of the (now deprecated) SMTP module simplesmtp.For matching SMTP client see smtp-connection. SES TRANSPORT :: NODEMAILER SES transport. Nodemailer SES transport is a wrapper around aws.SES from the aws-sdk package. SES transport is available from Nodemailer v3.1.0. Why not use aws-sdk directly? The SES API exposes two methods to send mail – SendEmail and SendRawEmail.While the first one is really easy to use and Nodemailer is not actually needed, then it is also quite basic in features. OAUTH2 :: NODEMAILER OAuth2. OAuth2 allows your application to store and use authentication tokens instead of actual login credentials. This is great for security as tokens or valid only for specific actions and can be easily revoked thus, once stolen, can’t to as much harm as actual account

credentials.

CUSTOM AUTHENTICATION :: NODEMAILER Custom authentication. Available from Nodemailer v5.1.0. Nodemailer SMTP client can be extended to use custom authentication mechanisms that Nodemailer does not support by default. To use one you should define a custom authentication handler with customAuth in the transporter options. Multiple handlers can be defined. SEND E-MAILS WITH NODE.JS Install with npm. npm install nodemailer@2.7.2. To send e-mails you need a transporter object. var transporter = nodemailer.createTransport (transport ) Where. transporter is going to be an object that is able to send mail. transport is the transport configuration object, connection url or a transport plugin

instance.

TRACKING EMAIL REPLIES WITH IMAP API Tracking replies is basically a filtered use case of tracking all new messages. You get a notification that a message was added to INBOX (or Junk if you care about potential false-positive spam messages). Then perform basic checks to detect if this message is a “normal” message or a reply. If it is a reply then validate if it is a reply to Powered by OUTFUNNEL

* 1. Nodemailer

* Migration

* License

* 2. Usage

* SMTP? Say what?

* Using Gmail

* Delivering bulk mail * 3. Message configuration

* Attachments

* Alternatives

* Address object

* Calendar events

* Embedded images

* List headers

* Custom headers

* Custom source

* 4. SMTP transport

* SMTP envelope

* Pooled SMTP

* Testing SMTP

* OAuth2

* Custom authentication

* Proxy support

* Delivery status notifications * 5. Other transports * Sendmail transport

* SES transport

* Stream transport

* 6. Plugins

* Create plugins

* 7. DKIM

* 8. Extra modules

* SMTP Server

* SMTP Connection

* Mailparser

* Mailcomposer

* Node.js daemons

__ Nodemailer > Nodemailer

NODEMAILER

NODEMAILER is a module for Node.js applications to allow easy as cake email sending. The project got started back in 2010 when there was no sane option to send email messages, today it is the solution most Node.js users turn to by default. NODEMAILER is licensed under MIT LICENSE. See license details in the License page . If you are upgrading from Nodemailer v2 or older, then see the light migration guide here . npm install nodemailer SUPPORT NODEMAILER __ If you really like Nodemailer or your business benefits from it financially then I would really appreciate a small donation. You can either use Bitcoin or PayPal for donations. My Bitcoin wallet is: 15Z8ADxhssKUiwP3jbbqJwA21744KMCfTM. NODEMAILER FEATURES __ * A single module with ZERO DEPENDENCIES – code is easily auditable, as there are no dark corners * Heavy focus on SECURITY, no-one likes RCE vulnerabilities * UNICODE SUPPORT to use any characters, including emoji 💪 * WINDOWS SUPPORT – you can install it with npm on Windows just like any other module, there are no compiled dependencies. Use it hassle free from Azure or from your Windows box * Use HTML CONTENT, as well as PLAIN TEXT alternative * Add ATTACHMENTS to messages * EMBEDDED image attachments for HTML content – your design does not get blocked * Secure email delivery using TLS/STARTTLS * Different TRANSPORT METHODS in addition to the built-in SMTP SUPPORT * Sign messages with DKIM * Custom PLUGIN SUPPORT for manipulating messages * Sane OAUTH2 authentication * PROXIES for SMTP connections * ES6 CODE – no more unintentional memory leaks, due to hoisted

_var_’s

* Autogenerated email TEST ACCOUNTS from Ethereal.email

REQUIREMENTS __

* NODE.JS V6.0.0 or newer. That’s it. If you are able to run Node.js version 6 or newer, then you can use Nodemailer. There are no platform or resource specific requirements. All public Nodemailer methods support both callbacks and Promises (if callback is omitted). You need to have at least Node v8.0.0 if you want to use _async..await_ with Nodemailer.

TL;DR __

In short, what you need to do to send messages, would be the

following:

* Create a Nodemailer transporter using either SMTP or some other transport mechanism * Set up message options (who sends what to whom) * Deliver the message object using the SENDMAIL() method of your previously created transporter

EXAMPLE __

This is a complete example to send an email with plain text and HTML

body

'use strict';

const nodemailer = require('nodemailer'); // async..await is not allowed in global scope, must use a wrapper async function main() { // Generate test SMTP service account from ethereal.email // Only needed if you don't have a real mail account for testing let testAccount = await nodemailer.createTestAccount(); // create reusable transporter object using the default SMTP transport let transporter = nodemailer.createTransport({ host: 'smtp.ethereal.email',

port: 587,

secure: false, // true for 465, false for other ports

auth: {

user: testAccount.user, // generated ethereal user pass: testAccount.pass // generated ethereal password

}

});

// send mail with defined transport object let info = await transporter.sendMail({ from: '"Fred Foo 👻" ', // sender address to: 'bar@example.com, baz@example.com', // list of receivers subject: 'Hello ✔', // Subject line text: 'Hello world?', // plain text body html: 'Hello world?' // html body

});

console.log('Message sent: %s', info.messageId); // Message sent:  // Preview only available when sending through an Ethereal account console.log('Preview URL: %s', nodemailer.getTestMessageUrl(info)); // Preview URL: https://ethereal.email/message/WaQKMgKddxQDoou...

}

main().catch(console.error);

EXAMPLES __

* NODEMAILER AMQP EXAMPLE is an example of using RabbitMQ to manage Nodemailer email messages. Source

.

Output of the the example script as shown by the Ethereal mail catching

service:

SOURCE __

Nodemailer source can be found from Github

.

------------------------- Nodemailer is created by Andris Reinman . The Nodemailer logo was designed by Sven Kristjansen

.

__ __