(Node.js) Mailgun Send Send HTML Email with Attachments and HTML Images

See more Mailgun Examples

Sends an HTML email with images and attachments.

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

For more information, see https://documentation.mailgun.com/en/latest/api-sending.html#sending

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 example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var http = new chilkat.Http();

    http.Login = "api";
    http.Password = "sending_api_key";    //  Replace with your actual sending API key.

    var req = new chilkat.HttpRequest();
    req.HttpVerb = "POST";
    req.Path = "/v3/YOUR_DOMAIN_NAME/messages";
    req.ContentType = "multipart/form-data";

    // Change YOUR_DOMAIN_NAME to something like "mg.your-domain.com".
    req.AddParam("from","Your Name <mailgun@YOUR_DOMAIN_NAME>");
    req.AddParam("to","Joe Example <joe@example.com>");
    req.AddParam("subject","Hello Joe Example");
    req.AddParam("html","<html><body><b>This is the HTML body</b><br><img src=\"cid:cidStarfish.jpg\"></body></html>");

    // An a attachd file
    var bd = new chilkat.BinData();
    success = bd.LoadFile("qa_data/hamlet.zip");
    if (success == false) {
        console.log("Failed to load file attachment.");
        return;
    }

    req.AddBdForUpload("attachment","hamlet.zip",bd,"application/zip");

    // add an image as CID
    success = bd.LoadFile("qa_data/jpg/starfish.jpg");
    if (success == false) {
        console.log("Failed to load HTML image.");
        return;
    }

    req.AddBdForUpload("inline","cidStarfish.jpg",bd,"image/jpeg");

    var resp = new chilkat.HttpResponse();
    success = http.HttpSReq("api.mailgun.net",443,true,req,resp);
    if (success == false) {
        console.log(http.LastErrorText);
        return;
    }

    var sbResponseBody = new chilkat.StringBuilder();
    resp.GetBodySb(sbResponseBody);
    var jResp = new chilkat.JsonObject();
    jResp.LoadSb(sbResponseBody);
    jResp.EmitCompact = false;

    console.log("Response Body:");
    console.log(jResp.Emit());

    var respStatusCode = resp.StatusCode;
    console.log("Response Status Code = " + respStatusCode);
    if (respStatusCode >= 400) {
        console.log("Response Header:");
        console.log(resp.Header);
        console.log("Failed.");
        return;
    }

    // Sample JSON response:
    // (Sample code for parsing the JSON response is shown below)

    // {
    //   "id": "<20210429234809.1.2D550E1C94D3D98F@sandbox0e542e4c577f4bbb98c8bf6b6bca727b.mailgun.org>",
    //   "message": "Queued. Thank you."
    // }

    // Sample code for parsing the JSON response...
    // Use the following online tool to generate parsing code from sample JSON:
    // Generate Parsing Code from JSON

    var id = jResp.StringOf("id");
    var message = jResp.StringOf("message");

}

chilkatExample();