Sample code for 30+ languages & platforms
JavaScript Requires Chilkat v11.0.0+

Send a Gmail message with a file attachment

See more GMail REST API Examples

Live send. Prepare a small file named attachment.pdf and replace the sample addresses. Add the file as a MIME attachment and upload the complete message as message/rfc822. The response is a Gmail Message. For larger uploads or unreliable connections, see Google’s resumable upload guidance.

Authorize the application with https://www.googleapis.com/auth/gmail.send. The example reads the access token from gmail-token.json in a private working directory. Authorize a desktop application.

Google documentation

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

//  Assumes Chilkat is unlocked. See Global Unlock Sample.

var token = new CkJsonObject();
success = token.LoadFile("gmail-token.json");
if (success !== true) {
    console.log("Could not read gmail-token.json from the private working directory.");
    return;
}

if ((token.JsonTypeOf("access_token") !== 1) || (token.StringOfEquals("access_token","",true) == true)) {
    console.log("An OAuth access token is required.");
    return;
}

var http = new CkHttp();
http.RequireSslCertVerify = true;
http.AuthToken = token.StringOf("access_token");
var resp = new CkHttpResponse();
var reply = new CkJsonObject();
var email = new CkEmail();
//  Use the authorized mailbox or one of its configured send-as addresses.
email.From = "Sender <sender@example.com>";
success = email.AddTo("Recipient","recipient@example.net");
if (success !== true) {
    console.log(email.LastErrorText);
    return;
}

email.Subject = "Sample message";
email.Charset = "utf-8";
email.Body = "Hello from the Gmail API.";
var fileData = new CkBinData();
success = fileData.LoadFile("attachment.pdf");
if (success !== true) {
    console.log("Could not read attachment.pdf.");
    return;
}

success = email.AddAttachmentBd("attachment.pdf",fileData,"application/pdf");
if (success !== true) {
    console.log(email.LastErrorText);
    return;
}

var mime = new CkBinData();
success = email.GetMimeBd(mime);
if (success !== true) {
    console.log(email.LastErrorText);
    return;
}

success = http.HttpBd("POST","https://gmail.googleapis.com/upload/gmail/v1/users/me/messages/send?uploadType=media",mime,"message/rfc822",resp);
if (resp.StatusCode == 0) {
    console.log("Gmail did not return an HTTP response.");
    return;
}

if ((success !== true) || (resp.StatusCode < 200) || (resp.StatusCode >= 300)) {
    console.log("Gmail HTTP " + resp.StatusCode);
    success = reply.Load(resp.BodyStr);
    if (success == true) {
        console.log(reply.StringOf("error.message"));
    }

    return;
}

success = reply.Load(resp.BodyStr);
if (success !== true) {
    console.log("Expected a Gmail JSON response.");
    return;
}

if ((reply.JsonTypeOf("id") !== 1) || (reply.StringOfEquals("id","",true) == true)) {
    console.log("Expected id in the response.");
    return;
}

console.log("Gmail message ID: " + reply.StringOf("id"));