Objective-C

Create Group

See more Microsoft Group Examples

Create a new group as specified in the request body. You can create one of three types of groups:

• Office 365 Group (unified group)
• Dynamic group
• Security group

This operation returns by default only a subset of the properties for each group. These default properties are noted in the Properties section.

See https://docs.microsoft.com/en-us/graph/api/group-post-groups?view=graph-rest-1.0 for more information.

Objective-C

#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>
#import <NSString.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 as shown here:
//    Get Microsoft Graph OAuth2 Access Token with Group.ReadWrite.All scope.

CkoJsonObject *jsonToken = [[CkoJsonObject alloc] init];
success = [jsonToken LoadFile: @"qa_data/tokens/msGraphGroup.json"];
if (success == NO) {
    NSLog(@"%@",jsonToken.LastErrorText);
    return;
}

http.AuthToken = [jsonToken StringOf: @"access_token"];

// Create a JSON body for the HTTP POST
// Use this online tool to generate the code from sample JSON: 
// Generate Code to Create JSON

// {
//   "description": "Self help community for library",
//   "displayName": "Library Assist",
//   "groupTypes": [
//     "Unified"
//   ],
//   "mailEnabled": true,
//   "mailNickname": "library",
//   "securityEnabled": false
// }

CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"description" value: @"Self help community for library"];
[json UpdateString: @"displayName" value: @"Library Assist"];
[json UpdateString: @"groupTypes[0]" value: @"Unified"];
[json UpdateBool: @"mailEnabled" value: YES];
[json UpdateString: @"mailNickname" value: @"library"];
[json UpdateBool: @"securityEnabled" value: NO];

// POST the JSON to https://graph.microsoft.com/v1.0/groups

CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpJson: @"POST" url: @"https://graph.microsoft.com/v1.0/groups" json: json contentType: @"application/json" response: resp];
if (success == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

[json Load: resp.BodyStr];
json.EmitCompact = NO;

if ([resp.StatusCode intValue] != 201) {
    NSLog(@"%@",[json Emit]);
    NSLog(@"%@%d",@"Failed, response status code = ",[resp.StatusCode intValue]);
    return;
}

NSLog(@"%@",[json Emit]);

// A sample response:
// (See code for parsing this response below..)

// {
//     "id": "b320ee12-b1cd-4cca-b648-a437be61c5cd",
// 	  "deletedDateTime": null,
// 	  "classification": null,
// 	  "createdDateTime": "2018-12-22T00:51:37Z",
// 	  "creationOptions": [],
// 	  "description": "Self help community for library",
// 	  "displayName": "Library Assist",
// 	  "groupTypes": [
// 	      "Unified"
// 	  ],
// 	  "mail": "library7423@contoso.com",
// 	  "mailEnabled": true,
// 	  "mailNickname": "library",
// 	  "onPremisesLastSyncDateTime": null,
// 	  "onPremisesSecurityIdentifier": null,
// 	  "onPremisesSyncEnabled": null,
// 	  "preferredDataLocation": "CAN",
// 	  "proxyAddresses": [
// 	      "SMTP:library7423@contoso.com"
// 	  ],
// 	  "renewedDateTime": "2018-12-22T00:51:37Z",
// 	  "resourceBehaviorOptions": [],
// 	  "resourceProvisioningOptions": [],
// 	  "securityEnabled": false,
// 	  "visibility": "Public",
// 	  "onPremisesProvisioningErrors": []
// }

// Use this online tool to generate parsing code from sample JSON: 
// Generate Parsing Code from JSON

NSString *id = 0;
NSString *deletedDateTime = 0;
NSString *classification = 0;
NSString *createdDateTime = 0;
NSString *description = 0;
NSString *displayName = 0;
NSString *mail = 0;
BOOL mailEnabled;
NSString *mailNickname = 0;
NSString *onPremisesLastSyncDateTime = 0;
NSString *onPremisesSecurityIdentifier = 0;
NSString *onPremisesSyncEnabled = 0;
NSString *preferredDataLocation = 0;
NSString *renewedDateTime = 0;
BOOL securityEnabled;
NSString *visibility = 0;
int i;
int count_i;
NSString *strVal = 0;

id = [json StringOf: @"id"];
deletedDateTime = [json StringOf: @"deletedDateTime"];
classification = [json StringOf: @"classification"];
createdDateTime = [json StringOf: @"createdDateTime"];
description = [json StringOf: @"description"];
displayName = [json StringOf: @"displayName"];
mail = [json StringOf: @"mail"];
mailEnabled = [json BoolOf: @"mailEnabled"];
mailNickname = [json StringOf: @"mailNickname"];
onPremisesLastSyncDateTime = [json StringOf: @"onPremisesLastSyncDateTime"];
onPremisesSecurityIdentifier = [json StringOf: @"onPremisesSecurityIdentifier"];
onPremisesSyncEnabled = [json StringOf: @"onPremisesSyncEnabled"];
preferredDataLocation = [json StringOf: @"preferredDataLocation"];
renewedDateTime = [json StringOf: @"renewedDateTime"];
securityEnabled = [json BoolOf: @"securityEnabled"];
visibility = [json StringOf: @"visibility"];
i = 0;
count_i = [[json SizeOfArray: @"creationOptions"] intValue];
while (i < count_i) {
    json.I = [NSNumber numberWithInt: i];
    i = i + 1;
}

i = 0;
count_i = [[json SizeOfArray: @"groupTypes"] intValue];
while (i < count_i) {
    json.I = [NSNumber numberWithInt: i];
    strVal = [json StringOf: @"groupTypes[i]"];
    i = i + 1;
}

i = 0;
count_i = [[json SizeOfArray: @"proxyAddresses"] intValue];
while (i < count_i) {
    json.I = [NSNumber numberWithInt: i];
    strVal = [json StringOf: @"proxyAddresses[i]"];
    i = i + 1;
}

i = 0;
count_i = [[json SizeOfArray: @"resourceBehaviorOptions"] intValue];
while (i < count_i) {
    json.I = [NSNumber numberWithInt: i];
    // ...
    i = i + 1;
}

i = 0;
count_i = [[json SizeOfArray: @"resourceProvisioningOptions"] intValue];
while (i < count_i) {
    json.I = [NSNumber numberWithInt: i];
    // ...
    i = i + 1;
}

i = 0;
count_i = [[json SizeOfArray: @"onPremisesProvisioningErrors"] intValue];
while (i < count_i) {
    json.I = [NSNumber numberWithInt: i];
    // ...
    i = i + 1;
}

NSLog(@"%@",@"Success.");