JavaScript Requires Chilkat v11.0.0+

Outlook -- Create a Mail Folder

See more Outlook Examples

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

var success = false;

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

var http = new CkHttp();

//  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 CkHashtable();
var sbMap = new CkStringBuilder();
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 CkJsonObject();
jsonRequestBody.UpdateString("displayName","subFolderC");

http.SetUrlVar("folder_id",existingFolderId);

//  Create the folder "subFolderC" at the specified location.
var resp = new CkHttpResponse();
success = http.HttpJson("POST","https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/childFolders",jsonRequestBody,"application/json",resp);
if (success == false) {
    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 CkJsonObject();
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
//  	}