(Delphi ActiveX) 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 for Delphi Downloads Chilkat ActiveX DLL for Delphi Chilkat non-ActiveX DLL for Delphi * The examples here use the ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB;

...

procedure TForm1.Button1Click(Sender: TObject);
var
http: TChilkatHttp;
htFolderMap: TChilkatHashtable;
sbMap: TChilkatStringBuilder;
existingFolderId: WideString;
jsonRequestBody: TChilkatJsonObject;
resp: IChilkatHttpResponse;
jsonResponse: TChilkatJsonObject;

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

http := TChilkatHttp.Create(Self);

// 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 
htFolderMap := TChilkatHashtable.Create(Self);
sbMap := TChilkatStringBuilder.Create(Self);
sbMap.LoadFile('qa_data/outlook/folderMap.xml','utf-8');
htFolderMap.AddFromXmlSb(sbMap.ControlInterface);

existingFolderId := htFolderMap.LookupStr('/Inbox/abc');
if (htFolderMap.LastMethodSuccess <> 1) 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 := TChilkatJsonObject.Create(Self);
jsonRequestBody.UpdateString('displayName','subFolderC');

http.SetUrlVar('folder_id',existingFolderId);

// Create the folder "subFolderC" at the specified location.
resp := http.PostJson2('https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/childFolders','application/json',jsonRequestBody.Emit());
if (http.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(http.LastErrorText);
    Exit;
  end;

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

// Show the response in both cases..
jsonResponse := TChilkatJsonObject.Create(Self);
jsonResponse.EmitCompact := 0;
jsonResponse.Load(resp.BodyStr);
Memo1.Lines.Add(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
// 	}
end;