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.

C++

#include <CkHttp.h>
#include <CkJsonObject.h>
#include <CkHttpResponse.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    CkHttp http;

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

    CkJsonObject jsonToken;
    success = jsonToken.LoadFile("qa_data/tokens/msGraphGroup.json");
    if (success == false) {
        std::cout << jsonToken.lastErrorText() << "\r\n";
        return;
    }

    http.put_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
    //  }

    CkJsonObject json;
    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

    CkHttpResponse resp;
    success = http.HttpJson("POST","https://graph.microsoft.com/v1.0/groups",json,"application/json",resp);
    if (success == false) {
        std::cout << http.lastErrorText() << "\r\n";
        return;
    }

    json.Load(resp.bodyStr());
    json.put_EmitCompact(false);

    if (resp.get_StatusCode() != 201) {
        std::cout << json.emit() << "\r\n";
        std::cout << "Failed, response status code = " << resp.get_StatusCode() << "\r\n";
        return;
    }

    std::cout << json.emit() << "\r\n";

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

    const char *id = 0;
    const char *deletedDateTime = 0;
    const char *classification = 0;
    const char *createdDateTime = 0;
    const char *description = 0;
    const char *displayName = 0;
    const char *mail = 0;
    bool mailEnabled;
    const char *mailNickname = 0;
    const char *onPremisesLastSyncDateTime = 0;
    const char *onPremisesSecurityIdentifier = 0;
    const char *onPremisesSyncEnabled = 0;
    const char *preferredDataLocation = 0;
    const char *renewedDateTime = 0;
    bool securityEnabled;
    const char *visibility = 0;
    int i;
    int count_i;
    const char *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");
    while (i < count_i) {
        json.put_I(i);
        i = i + 1;
    }

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

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

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

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

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

    std::cout << "Success." << "\r\n";
    }