Sample code for 30+ languages & platforms
Dart 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 Dart Downloads

Dart
import 'package:chilkat/chilkat.dart';

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

  final http = 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 
  final htFolderMap = CkHashtable();
  final sbMap = CkStringBuilder();
  sbMap.loadFile('qa_data/outlook/folderMap.xml', 'utf-8');
  htFolderMap.addFromXmlSb(sbMap);

  final String existingFolderId;
  try {
    existingFolderId = htFolderMap.lookupStr('/Inbox/abc');
  } on ChilkatException {
    print('Folder ID not found');
    return;
  }

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

  // This example will create /Inbox/abc/subFolderC
  final jsonRequestBody = CkJsonObject();
  jsonRequestBody.updateString('displayName', 'subFolderC');

  http.setUrlVar('folder_id', existingFolderId);

  // Create the folder "subFolderC" at the specified location.
  final resp = CkHttpResponse();
  try {
    http.httpJson('POST', 'https://graph.microsoft.com/v1.0/me/mailFolders/{\$folder_id}/childFolders', jsonRequestBody, 'application/json', resp);
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // A 201 response indicates success.
  if (http.lastStatus == 201) {
    print('Folder created.');
  } else {
    print('Response status code = ${resp.statusCode}');
    print('Error: Folder not created.');
  }

  // Show the response in both cases..
  final jsonResponse = CkJsonObject();
  jsonResponse.emitCompact = false;
  jsonResponse.load(resp.bodyStr);
  print(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
  // 	}
}