Chilkat Online Tools

C / Zoom API / Add group admins

Back to Collection Items

#include <C_CkHttp.h>
#include <C_CkHttpRequest.h>
#include <C_CkJsonArray.h>
#include <C_CkJsonObject.h>
#include <C_CkHttpResponse.h>

void ChilkatSample(void)
    {
    HCkHttp http;
    BOOL success;
    HCkHttpRequest req;
    HCkJsonArray jsonFormData1;
    HCkJsonObject jsonObj_1;
    HCkHttpResponse resp;

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

    http = CkHttp_Create();

    req = CkHttpRequest_Create();
    CkHttpRequest_putHttpVerb(req,"POST");
    CkHttpRequest_putPath(req,"/v2/groups/:groupId/admins");
    CkHttpRequest_putContentType(req,"multipart/form-data");

    jsonFormData1 = CkJsonArray_Create();

    CkJsonArray_AddObjectAt(jsonFormData1,-1);
    jsonObj_1 = CkJsonArray_ObjectAt(jsonFormData1,CkJsonArray_getSize(jsonFormData1) - 1);
    CkJsonObject_UpdateString(jsonObj_1,"id","Ut veniam nostrud nisi");
    CkJsonObject_UpdateString(jsonObj_1,"email","nostrud exercitation");
    CkJsonObject_Dispose(jsonObj_1);

    CkJsonArray_AddObjectAt(jsonFormData1,-1);
    jsonObj_1 = CkJsonArray_ObjectAt(jsonFormData1,CkJsonArray_getSize(jsonFormData1) - 1);
    CkJsonObject_UpdateString(jsonObj_1,"id","aliquip cillum");
    CkJsonObject_UpdateString(jsonObj_1,"email","amet labore dolor in consectetur");
    CkJsonObject_Dispose(jsonObj_1);

    CkHttpRequest_AddParam(req,"admins",CkJsonArray_emit(jsonFormData1));

    CkHttpRequest_AddHeader(req,"Authorization","Bearer <access_token>");

    resp = CkHttp_SynchronousRequest(http,"api.zoom.us",443,TRUE,req);
    if (CkHttp_getLastMethodSuccess(http) == FALSE) {
        printf("%s\n",CkHttp_lastErrorText(http));
        CkHttp_Dispose(http);
        CkHttpRequest_Dispose(req);
        CkJsonArray_Dispose(jsonFormData1);
        return;
    }

    printf("%d\n",CkHttpResponse_getStatusCode(resp));
    printf("%s\n",CkHttpResponse_bodyStr(resp));
    CkHttpResponse_Dispose(resp);


    CkHttp_Dispose(http);
    CkHttpRequest_Dispose(req);
    CkJsonArray_Dispose(jsonFormData1);

    }

Curl Command

curl -X POST
	-H "Authorization: Bearer <access_token>"
	-H "Content-Type: multipart/form-data"
	--form 'admins=[{"id":"Ut veniam nostrud nisi","email":"nostrud exercitation"},{"id":"aliquip cillum","email":"amet labore dolor in consectetur"}]'
https://api.zoom.us/v2/groups/:groupId/admins

Postman Collection Item JSON

{
  "name": "Add group admins",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Content-Type",
        "value": "multipart/form-data"
      }
    ],
    "body": {
      "mode": "formdata",
      "formdata": [
        {
          "key": "admins",
          "value": "[{\"id\":\"Ut veniam nostrud nisi\",\"email\":\"nostrud exercitation\"},{\"id\":\"aliquip cillum\",\"email\":\"amet labore dolor in consectetur\"}]",
          "description": "A list of the administrators to add to a group.",
          "type": "text"
        }
      ]
    },
    "url": {
      "raw": "{{baseUrl}}/groups/:groupId/admins",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "groups",
        ":groupId",
        "admins"
      ],
      "variable": [
        {
          "key": "groupId",
          "value": "quis officia in reprehenderit",
          "description": "(Required) The group ID.<br>\nCan be retrieved by calling [GET /groups](https://marketplace.zoom.us/docs/api-reference/zoom-api/groups/groups)."
        }
      ]
    },
    "description": "Use this API to add administrators to a [group](https://support.zoom.us/hc/en-us/articles/204519819-Group-Management-) under your account.\n\n**Scopes:** `group:write:admin`<br>**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`\n\n**Prerequisites:** \n* A Pro, Business, or Education account"
  },
  "response": [
    {
      "name": "**Status Code:** `200` <br> Only available for paid account: \"{accountId}\".",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "description": "Added as a part of security scheme: oauth2",
            "key": "Authorization",
            "value": "<token>"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "admins",
              "value": "[{\"id\":\"enim amet aliqua\",\"email\":\"mollit aliqua consectetur\"},{\"id\":\"proident officia anim\",\"email\":\"ullamco do\"}]",
              "description": "A list of the administrators to add to a group.",
              "type": "text"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/groups/:groupId/admins",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "groups",
            ":groupId",
            "admins"
          ],
          "variable": [
            {
              "key": "groupId",
              "value": "quis officia in reprehenderit",
              "description": "(Required) The group ID.<br>\nCan be retrieved by calling [GET /groups](https://marketplace.zoom.us/docs/api-reference/zoom-api/groups/groups)."
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "text",
      "header": [
        {
          "key": "Content-Type",
          "value": "text/plain"
        }
      ],
      "cookie": [
      ],
      "body": ""
    },
    {
      "name": "**Status Code:** `201` <br> Group administrator added.",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "description": "Added as a part of security scheme: oauth2",
            "key": "Authorization",
            "value": "<token>"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "admins",
              "value": "[{\"id\":\"enim amet aliqua\",\"email\":\"mollit aliqua consectetur\"},{\"id\":\"proident officia anim\",\"email\":\"ullamco do\"}]",
              "description": "A list of the administrators to add to a group.",
              "type": "text"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/groups/:groupId/admins",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "groups",
            ":groupId",
            "admins"
          ],
          "variable": [
            {
              "key": "groupId",
              "value": "quis officia in reprehenderit",
              "description": "(Required) The group ID.<br>\nCan be retrieved by calling [GET /groups](https://marketplace.zoom.us/docs/api-reference/zoom-api/groups/groups)."
            }
          ]
        }
      },
      "status": "Created",
      "code": 201,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"ids\": [\n  \"abc4545fdgfdhg\",\n  \"lgfdkhg123456\"\n ],\n \"added_at\": \"2019-09-27T00:14:46Z\"\n}"
    },
    {
      "name": "**Status Code:** `404` <br> Not found. <br> **Error Code:** `4130` <br> A group with the \"{groupId}\" ID does not exist.",
      "originalRequest": {
        "method": "POST",
        "header": [
          {
            "description": "Added as a part of security scheme: oauth2",
            "key": "Authorization",
            "value": "<token>"
          }
        ],
        "body": {
          "mode": "formdata",
          "formdata": [
            {
              "key": "admins",
              "value": "[{\"id\":\"enim amet aliqua\",\"email\":\"mollit aliqua consectetur\"},{\"id\":\"proident officia anim\",\"email\":\"ullamco do\"}]",
              "description": "A list of the administrators to add to a group.",
              "type": "text"
            }
          ]
        },
        "url": {
          "raw": "{{baseUrl}}/groups/:groupId/admins",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "groups",
            ":groupId",
            "admins"
          ],
          "variable": [
            {
              "key": "groupId",
              "value": "quis officia in reprehenderit",
              "description": "(Required) The group ID.<br>\nCan be retrieved by calling [GET /groups](https://marketplace.zoom.us/docs/api-reference/zoom-api/groups/groups)."
            }
          ]
        }
      },
      "status": "Not Found",
      "code": 404,
      "_postman_previewlanguage": "text",
      "header": [
        {
          "key": "Content-Type",
          "value": "text/plain"
        }
      ],
      "cookie": [
      ],
      "body": ""
    }
  ]
}