Sample code for 30+ languages & platforms
Node.js

Insert Email into GMail Folder

See more GMail REST API Examples

Directly inserts a message into only this user's mailbox similar to IMAP APPEND, bypassing most scanning and classification. Does not send a message.

This example will create a Chilkat Email object and upload/insert it into GMail. Then adds the "INBOX" label to the email to make it appear in INBOX

Chilkat Node.js Downloads

Node.js
NODEJS_PRELUDE

function chilkatExample() {

    var success = false;

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

    var email = new chilkat.Email();

    //  This example chooses to load an email from a file.
    success = email.LoadEml("qa_data/eml/testEmail.eml");
    if (success == false) {
        console.log(email.LastErrorText);
        return;
    }

    //  Get the email as MIME.
    var sbMime = new chilkat.StringBuilder();
    email.GetMimeSb(sbMime);

    var http = new chilkat.Http();
    var resp = new chilkat.HttpResponse();

    http.AuthToken = "GMAIL-ACCESS-TOKEN";

    //  Upload to GMail (does not send, but just inserts).

    //  IMPORTANT: After uploading/inserting, you won't see the message in the Inbox.
    //  In your web browser, if you go to "All Mail", you will see it.

    var url = "https://www.googleapis.com/upload/gmail/v1/users/me/messages?uploadType=media";
    http.UncommonOptions = "SendGzipped";
    success = http.HttpSb("POST",url,sbMime,"utf-8","message/rfc822",resp);
    if (success == false) {
        console.log(http.LastErrorText);
        return;
    }

    http.UncommonOptions = "";

    //  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.
    //  A sample successful JSON response:

    //  {
    //   "id": "166f583051d36144",
    //   "threadId": "166f5529e079a456"
    //  }

    var json = new chilkat.JsonObject();
    json.Load(resp.BodyStr);
    var id = json.StringOf("id");

    //  Add the Inbox label to the inserted email so that it appears in Inbox.
    console.log("---- Adding the Inbox label to the newly inserted email. ----");

    //  Create the following JSON to be sent in a POST to modify labels for this message.
    //  {
    //    "addLabelIds": [
    //      "INBOX"
    //      ]
    //  }

    var json2 = new chilkat.JsonObject();
    json2.UpdateString("addLabelIds[0]","INBOX");

    http.SetUrlVar("id",id);
    url = "https://www.googleapis.com/gmail/v1/users/me/messages/{$id}/modify";

    success = http.HttpJson("POST",url,json2,"application/json",resp);
    if (success == false) {
        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.
    //  A sample successful JSON response:

    //  {
    //   "id": "166f583051d36144",
    //   "threadId": "166f583051d36144",
    //   "labelIds": [
    //    "INBOX"
    //   ]
    //  }

}

chilkatExample();