(PHP 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 ActiveX Downloads ActiveX for 32-bit and 64-bit Windows Note: The php_com_dotnet.dll may need to be enabled inside of php.ini.

<?php

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

// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Http')
$http = new COM("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 
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.Hashtable')
$htFolderMap = new COM("Chilkat.Hashtable");
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.StringBuilder')
$sbMap = new COM("Chilkat.StringBuilder");
$sbMap->LoadFile('qa_data/outlook/folderMap.xml','utf-8');
$htFolderMap->AddFromXmlSb($sbMap);

$existingFolderId = $htFolderMap->lookupStr('/Inbox/abc');
if ($htFolderMap->LastMethodSuccess != 1) {
    print 'Folder ID not found' . "\n";
    exit;
}

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

// This example will create /Inbox/abc/subFolderC
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject')
$jsonRequestBody = new COM("Chilkat.JsonObject");
$jsonRequestBody->UpdateString('displayName','subFolderC');

$http->SetUrlVar('folder_id',$existingFolderId);

// Create the folder "subFolderC" at the specified location.
// resp is a Chilkat.HttpResponse
$resp = $http->PostJson2('https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/childFolders','application/json',$jsonRequestBody->emit());
if ($http->LastMethodSuccess != 1) {
    print $http->LastErrorText . "\n";
    exit;
}

// A 201 response indicates success.
if ($http->LastStatus == 201) {
    print 'Folder created.' . "\n";
}
else {
    print 'Response status code = ' . $resp->StatusCode . "\n";
    print 'Error: Folder not created.' . "\n";
}

// Show the response in both cases..
// For versions of Chilkat < 10.0.0, use new COM('Chilkat_9_5_0.Chilkat.JsonObject')
$jsonResponse = new COM("Chilkat.JsonObject");
$jsonResponse->EmitCompact = 0;
$jsonResponse->Load($resp->BodyStr);
print $jsonResponse->emit() . "\n";

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

?>