Sample code for 30+ languages & platforms
Delphi DLL 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.

Chilkat Delphi DLL Downloads

Delphi DLL
var
success: Boolean;
http: HCkHttp;
htFolderMap: HCkHashtable;
sbMap: HCkStringBuilder;
existingFolderId: PWideChar;
jsonRequestBody: HCkJsonObject;
resp: HCkHttpResponse;
jsonResponse: HCkJsonObject;

begin
success := False;

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

http := CkHttp_Create();

//  Use your previously obtained access token here:
CkHttp_putAuthToken(http,'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 
htFolderMap := CkHashtable_Create();
sbMap := CkStringBuilder_Create();
CkStringBuilder_LoadFile(sbMap,'qa_data/outlook/folderMap.xml','utf-8');
CkHashtable_AddFromXmlSb(htFolderMap,sbMap);

existingFolderId := CkHashtable__lookupStr(htFolderMap,'/Inbox/abc');
if (CkHashtable_getLastMethodSuccess(htFolderMap) <> True) then
  begin
    Memo1.Lines.Add('Folder ID not found');
    Exit;
  end;
//  Create a JSON request body with this content:
//  
//  	{
//  	  "displayName": "displayName-value",
//  	}

//  This example will create /Inbox/abc/subFolderC
jsonRequestBody := CkJsonObject_Create();
CkJsonObject_UpdateString(jsonRequestBody,'displayName','subFolderC');

CkHttp_SetUrlVar(http,'folder_id',existingFolderId);

//  Create the folder "subFolderC" at the specified location.
resp := CkHttpResponse_Create();
success := CkHttp_HttpJson(http,'POST','https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/childFolders',jsonRequestBody,'application/json',resp);
if (success = False) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

//  A 201 response indicates success.
if (CkHttp_getLastStatus(http) = 201) then
  begin
    Memo1.Lines.Add('Folder created.');
  end
else
  begin
    Memo1.Lines.Add('Response status code = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
    Memo1.Lines.Add('Error: Folder not created.');
  end;

//  Show the response in both cases..
jsonResponse := CkJsonObject_Create();
CkJsonObject_putEmitCompact(jsonResponse,False);
CkJsonObject_Load(jsonResponse,CkHttpResponse__bodyStr(resp));
Memo1.Lines.Add(CkJsonObject__emit(jsonResponse));

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

CkHttp_Dispose(http);
CkHashtable_Dispose(htFolderMap);
CkStringBuilder_Dispose(sbMap);
CkJsonObject_Dispose(jsonRequestBody);
CkHttpResponse_Dispose(resp);
CkJsonObject_Dispose(jsonResponse);