(Node.js) Outlook -- Create a Mail Folder

Creates a new mail folder as a child of an existing mail folder.

Note: This example requires Chilkat v9.5.0.68 or greater.

This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

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 http = new chilkat.Http();

    // Use your previously obtained access token here:
    http.AuthToken = "MICROSOFT_GRAPH_ACCESS_TOKEN";

    // This example will create a new mail folder as a child of /Inbox/abc

    // Get the existing folder ID from the folder map created by this example 
    var htFolderMap = new chilkat.Hashtable();
    var sbMap = new chilkat.StringBuilder();
    sbMap.LoadFile("qa_data/outlook/folderMap.xml","utf-8");
    htFolderMap.AddFromXmlSb(sbMap);

    var existingFolderId = htFolderMap.LookupStr("/Inbox/abc");
    if (htFolderMap.LastMethodSuccess !== true) {
        console.log("Folder ID not found");
        return;
    }

    // Create a JSON request body with this content:
    // 
    // 	{
    // 	  "displayName": "displayName-value",
    // 	}

    // This example will create /Inbox/abc/subFolderC
    var jsonRequestBody = new chilkat.JsonObject();
    jsonRequestBody.UpdateString("displayName","subFolderC");

    http.SetUrlVar("folder_id",existingFolderId);

    // Create the folder "subFolderC" at the specified location.
    // resp: HttpResponse
    var resp = http.PostJson2("https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/childFolders","application/json",jsonRequestBody.Emit());
    if (http.LastMethodSuccess !== true) {
        console.log(http.LastErrorText);
        return;
    }

    // A 201 response indicates success.
    if (http.LastStatus == 201) {
        console.log("Folder created.");
    }
    else {
        console.log("Response status code = " + resp.StatusCode);
        console.log("Error: Folder not created.");
    }

    // Show the response in both cases..
    var jsonResponse = new chilkat.JsonObject();
    jsonResponse.EmitCompact = false;
    jsonResponse.Load(resp.BodyStr);
    console.log(jsonResponse.Emit());

    // A sample successful JSON response looks like this:

    // 	{
    // 	  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA%3D')/childFolders/$entity",
    // 	  "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAM6JqMIAAAA=",
    // 	  "displayName": "subFolderC",
    // 	  "parentFolderId": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA=",
    // 	  "childFolderCount": 0,
    // 	  "unreadItemCount": 0,
    // 	  "totalItemCount": 0
    // 	}

}

chilkatExample();