(Node.js) SendGrid HTML Email with Embedded Images

See more SendGrid Examples

Demonstrates how to send an HTML email with embedded images using SendGrid.

Note: This example requires Chilkat v11.0.0 or greater.

Install Chilkat for Node.js and Electron using npm at

Chilkat npm packages for Node.js
Chilkat npm packages for Electron
on Windows, Linux, MacOS

var os = require('os');
if (os.platform() == 'win32') {  
  var chilkat = require('@chilkat/ck-node23-win64'); 
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node23-linux-arm');
    } else if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node23-linux-arm64');
    } else {
        var chilkat = require('@chilkat/ck-node23-linux-x64');
    }
} else if (os.platform() == 'darwin') {
  var chilkat = require('@chilkat/ck-node23-mac-universal');
}

function chilkatExample() {

    var success = false;

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

    var req = new chilkat.HttpRequest();
    var http = new chilkat.Http();

    // First.. load a JPG file and build an HTML img tag with the JPG data inline encoded.
    // Our HTML img tag will look like this:
    // <img src="data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA3ADcAA..." alt="" style="border-width:0px;" />
    var bdJpg = new chilkat.BinData();
    success = bdJpg.LoadFile("qa_data/jpg/starfish.jpg");
    if (success == false) {
        console.log("Failed to load JPG file.");
        return;
    }

    // Note: HTML containing embedded base64 image data may not be visible in all email clients.
    // For example, GMail might not display the image, but viewing in Outlook might be OK.
    var sbHtml = new chilkat.StringBuilder();
    sbHtml.Append("<html><body><b>This is a test<b><br /><img src=\"data:image/jpeg;base64,");
    // Append the base64 image data to sbHtml.
    bdJpg.GetEncodedSb("base64",sbHtml);
    sbHtml.Append("\" alt=\"\" style=\"border-width:0px;\" /></body></html>");

    var json = new chilkat.JsonObject();
    json.UpdateString("personalizations[0].to[0].email","matt@chilkat.io");
    json.UpdateString("personalizations[0].to[0].name","Matt");
    json.UpdateString("from.email","admin@chilkatsoft.com");
    json.UpdateString("subject","Test HTML email with images");
    json.UpdateString("content[0].type","text/html");
    json.UpdateSb("content[0].value",sbHtml);

    http.AuthToken = "SENDGRID_API_KEY";

    var resp = new chilkat.HttpResponse();
    success = http.HttpJson("POST","https://api.sendgrid.com/v3/mail/send",json,"application/json",resp);
    if (success == false) {
        console.log(http.LastErrorText);
        return;
    }

    console.log("response status code: " + resp.StatusCode);
    // Display the response.
    // If successful, the response code is 202 and the response body string is empty.
    // (The response body string may also be empty for error response codes.)
    console.log(resp.BodyStr);

}

chilkatExample();