Objective-C

Outlook -- Create a Mail Folder

See more Outlook Examples

Creates a new mail folder as a child of an existing mail folder. Objective-C

#import <CkoHttp.h>
#import <CkoHashtable.h>
#import <CkoStringBuilder.h>
#import <NSString.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>

BOOL success = NO;

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

CkoHttp *http = [[CkoHttp alloc] init];

// 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 
CkoHashtable *htFolderMap = [[CkoHashtable alloc] init];
CkoStringBuilder *sbMap = [[CkoStringBuilder alloc] init];
[sbMap LoadFile: @"qa_data/outlook/folderMap.xml" charset: @"utf-8"];
[htFolderMap AddFromXmlSb: sbMap];

NSString *existingFolderId = [htFolderMap LookupStr: @"/Inbox/abc"];
if (htFolderMap.LastMethodSuccess != YES) {
    NSLog(@"%@",@"Folder ID not found");
    return;
}

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

// This example will create /Inbox/abc/subFolderC
CkoJsonObject *jsonRequestBody = [[CkoJsonObject alloc] init];
[jsonRequestBody UpdateString: @"displayName" value: @"subFolderC"];

[http SetUrlVar: @"folder_id" value: existingFolderId];

// Create the folder "subFolderC" at the specified location.
CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpJson: @"POST" url: @"https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/childFolders" json: jsonRequestBody contentType: @"application/json" response: resp];
if (success == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

// A 201 response indicates success.
if ([http.LastStatus intValue] == 201) {
    NSLog(@"%@",@"Folder created.");
}
else {
    NSLog(@"%@%d",@"Response status code = ",[resp.StatusCode intValue]);
    NSLog(@"%@",@"Error: Folder not created.");
}

// Show the response in both cases..
CkoJsonObject *jsonResponse = [[CkoJsonObject alloc] init];
jsonResponse.EmitCompact = NO;
[jsonResponse Load: resp.BodyStr];
NSLog(@"%@",[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
// 	}