(Node.js) Send GMail with Attachments

Demonstrates how to send an email containing attachments using the GMail REST API.

Install Chilkat for Node.js and Electron using npm at

Chilkat npm packages for Node.js
Chilkat npm packages for Electron
on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var success;

    // Use the Chilkat Email API to create or load an email.
    var email = new chilkat.Email();

    // The From name/address don't need to be specified. 
    // GMail will automatically use your Gmail address if the following 2 lines are omitted.
    email.FromName = "My Name";
    email.FromAddress = "my_account_name@gmail.com";

    email.AddTo("John Smith","somebody@somewhere.com");
    // To add more recipients, make additional calls to AddTo or AddCC, one per recipient...

    email.Subject = "This is a test GMail email created using Chilkat.";
    email.Charset = "utf-8";
    email.AddPlainTextAlternativeBody("This is a test");

    // Create an HTML email body with an embedded image.
    var cid = email.AddRelatedFile("qa_data/jpg/starfish.jpg");
    var sbHtml = new chilkat.StringBuilder();
    sbHtml.Append("<html><body>This is a <b>test</b><br><img src=\"cid:STARFISH_CID\"/></body></html>");
    var numReplacements = sbHtml.Replace("STARFISH_CID",cid);

    email.AddHtmlAlternativeBody(sbHtml.GetAsString());

    // Add some attachments..
    var mimeType = email.AddFileAttachment("qa_data/helloWorld.pdf");
    if (email.LastMethodSuccess !== true) {
        console.log("Failed to add PDF attachment.");
        return;
    }

    mimeType = email.AddFileAttachment("qa_data/msword/sample2.docx");
    if (email.LastMethodSuccess !== true) {
        console.log("Failed to add MS-Word attachment.");
        return;
    }

    // OK.. we now have an HTML email with 2 attachments..
    var sbMime = new chilkat.StringBuilder();
    email.GetMimeSb(sbMime);

    // Send the email.  (GMail has a 5MB limit on the total email size.)
    var http = new chilkat.Http();
    http.AuthToken = "GMAIL-ACCESS-TOKEN";

    // Send using the simple upload request for the Gmail API
    var url = "https://www.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media";
    var sendGzipped = true;
    // resp: HttpResponse
    var resp = http.PTextSb("POST",url,sbMime,"utf-8","message/rfc822",false,sendGzipped);
    if (http.LastMethodSuccess !== true) {
        console.log(http.LastErrorText);
        return;
    }

    // A status code of 200 indicates success.
    console.log("Response status code: " + resp.StatusCode);
    console.log("Response body:");
    console.log(resp.BodyStr);

    // The response body contains JSON.
    // Use the online tool at Generate JSON Parsing Code
    // to generate JSON parsing code.

    // A sample successful JSON response:

    // {
    //  "id": "166f0d4ac39e50bf",
    //  "threadId": "166f0d4ac39e50bf",
    //  "labelIds": [
    //   "SENT"
    //  ]
    // }

}

chilkatExample();