(Lianja) 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

Chilkat Lianja Extension Download Chilkat Lianja Extension

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

loHttp = createobject("CkHttp")

// Use your previously obtained access token here:
loHttp.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 
loHtFolderMap = createobject("CkHashtable")
loSbMap = createobject("CkStringBuilder")
loSbMap.LoadFile("qa_data/outlook/folderMap.xml","utf-8")
loHtFolderMap.AddFromXmlSb(loSbMap)

lcExistingFolderId = loHtFolderMap.LookupStr("/Inbox/abc")
if (loHtFolderMap.LastMethodSuccess <> .T.) then
    ? "Folder ID not found"
    release loHttp
    release loHtFolderMap
    release loSbMap
    return
endif

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

// This example will create /Inbox/abc/subFolderC
loJsonRequestBody = createobject("CkJsonObject")
loJsonRequestBody.UpdateString("displayName","subFolderC")

loHttp.SetUrlVar("folder_id",lcExistingFolderId)

// Create the folder "subFolderC" at the specified location.
loResp = loHttp.PostJson2("https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/childFolders","application/json",loJsonRequestBody.Emit())
if (loHttp.LastMethodSuccess <> .T.) then
    ? loHttp.LastErrorText
    release loHttp
    release loHtFolderMap
    release loSbMap
    release loJsonRequestBody
    return
endif

// A 201 response indicates success.
if (loHttp.LastStatus = 201) then
    ? "Folder created."
else
    ? "Response status code = " + str(loResp.StatusCode)
    ? "Error: Folder not created."
endif

// Show the response in both cases..
loJsonResponse = createobject("CkJsonObject")
loJsonResponse.EmitCompact = .F.
loJsonResponse.Load(loResp.BodyStr)
? loJsonResponse.Emit()

release loResp

// 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
// 	}


release loHttp
release loHtFolderMap
release loSbMap
release loJsonRequestBody
release loJsonResponse