JavaScript

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.

JavaScript

var success = false;

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

var http = new CkHttp();

// Use your previously obtained access token as shown here:
//    Get Microsoft Graph OAuth2 Access Token with Group.ReadWrite.All scope.

var jsonToken = new CkJsonObject();
success = jsonToken.LoadFile("qa_data/tokens/msGraphGroup.json");
if (success == false) {
    console.log(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
// }

var json = new CkJsonObject();
json.UpdateString("description","Self help community for library");
json.UpdateString("displayName","Library Assist");
json.UpdateString("groupTypes[0]","Unified");
json.UpdateBool("mailEnabled",true);
json.UpdateString("mailNickname","library");
json.UpdateBool("securityEnabled",false);

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

var resp = new CkHttpResponse();
success = http.HttpJson("POST","https://graph.microsoft.com/v1.0/groups",json,"application/json",resp);
if (success == false) {
    console.log(http.LastErrorText);
    return;
}

json.Load(resp.BodyStr);
json.EmitCompact = false;

if (resp.StatusCode !== 201) {
    console.log(json.Emit());
    console.log("Failed, response status code = " + resp.StatusCode);
    return;
}

console.log(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

var id;
var deletedDateTime;
var classification;
var createdDateTime;
var description;
var displayName;
var mail;
var mailEnabled;
var mailNickname;
var onPremisesLastSyncDateTime;
var onPremisesSecurityIdentifier;
var onPremisesSyncEnabled;
var preferredDataLocation;
var renewedDateTime;
var securityEnabled;
var visibility;
var i;
var count_i;
var strVal;

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");
while (i < count_i) {
    json.I = i;
    i = i+1;
}

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

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

i = 0;
count_i = json.SizeOfArray("resourceBehaviorOptions");
while (i < count_i) {
    json.I = i;
    // ...
    i = i+1;
}

i = 0;
count_i = json.SizeOfArray("resourceProvisioningOptions");
while (i < count_i) {
    json.I = i;
    // ...
    i = i+1;
}

i = 0;
count_i = json.SizeOfArray("onPremisesProvisioningErrors");
while (i < count_i) {
    json.I = i;
    // ...
    i = i+1;
}

console.log("Success.");