Chilkat Online Tools

unicodeCpp / DocuSign REST API / Adds news user to the specified account.

Back to Collection Items

#include <CkHttpW.h>
#include <CkJsonObjectW.h>
#include <CkHttpResponseW.h>

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

    CkHttpW http;
    bool success;

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

    // The following JSON is sent in the request body.

    // {
    //   "newUsers": [
    //     {
    //       "userName": "sample string 1",
    //       "userId": "sample string 2",
    //       "userType": "sample string 3",
    //       "isAdmin": "sample string 4",
    //       "userStatus": "sample string 5",
    //       "uri": "sample string 6",
    //       "email": "sample string 7",
    //       "password": "sample string 8",
    //       "title": "sample string 9",
    //       "createdDateTime": "sample string 10",
    //       "firstName": "sample string 11",
    //       "middleName": "sample string 12",
    //       "lastName": "sample string 13",
    //       "suffixName": "sample string 14",
    //       "permissionProfileId": "sample string 15",
    //       "permissionProfileName": "sample string 16",
    //       "countryCode": "sample string 17",
    //       "subscribe": "sample string 18",
    //       "userSettings": [
    //         {}
    //       ],
    //       "accountManagementGranular": {
    //         "canManageUsers": "sample string 1",
    //         "canManageAdmins": "sample string 2",
    //         "canManageGroups": "sample string 3",
    //         "canManageSharing": "sample string 4",
    //         "canManageEnvelopeTransfer": "sample string 5",
    //         "canManageAccountSettings": "sample string 6",
    //         "canManageReporting": "sample string 7",
    //         "canManageAccountSecuritySettings": "sample string 8",
    //         "canManageSigningGroups": "sample string 9",
    //         "canManageDocumentRetention": "sample string 10",
    //         "canViewUsers": "sample string 11",
    //         "canManageUsersMetadata": {
    //           "rights": "sample string 1",
    //           "uiHint": "sample string 2",
    //           "uiType": "sample string 3",
    //           "uiOrder": "sample string 4",
    //           "is21CFRPart11": "sample string 5",
    //           "options": [
    //             "sample string 1"
    //           ]
    //         },
    //         "canManageAdminsMetadata": {},
    //         "canManageGroupsMetadata": {},
    //         "canManageSharingMetadata": {},
    //         "canManageEnvelopeTransferMetadata": {},
    //         "canManageAccountSettingsMetadata": {},
    //         "canManageReportingMetadata": {},
    //         "canManageAccountSecuritySettingsMetadata": {},
    //         "canManageSigningGroupsMetadata": {},
    //         "canManageDocumentRetentionMetadata": {},
    //         "canViewUsersMetadata": {}
    //       },
    //       "sendActivationOnInvalidLogin": "sample string 19",
    //       "activationAccessCode": "sample string 20",
    //       "enableConnectForUser": "sample string 21",
    //       "forgottenPasswordInfo": {
    //         "forgottenPasswordQuestion1": "sample string 1",
    //         "forgottenPasswordAnswer1": "sample string 2",
    //         "forgottenPasswordQuestion2": "sample string 3",
    //         "forgottenPasswordAnswer2": "sample string 4",
    //         "forgottenPasswordQuestion3": "sample string 5",
    //         "forgottenPasswordAnswer3": "sample string 6",
    //         "forgottenPasswordQuestion4": "sample string 7",
    //         "forgottenPasswordAnswer4": "sample string 8"
    //       },
    //       "groupList": [
    //         {
    //           "groupId": "sample string 1",
    //           "groupName": "sample string 2",
    //           "permissionProfileId": "sample string 3",
    //           "groupType": "sample string 4",
    //           "users": [
    //             {
    //               "userName": "sample string 1",
    //               "userId": "sample string 2",
    //               "email": "sample string 3",
    //               "userType": "sample string 4",
    //               "userStatus": "sample string 5",
    //               "uri": "sample string 6",
    //               "loginStatus": "sample string 7",
    //               "sendActivationEmail": "sample string 8",
    //               "activationAccessCode": "sample string 9"
    //             }
    //           ]
    //         }
    //       ],
    //       "workAddress": {
    //         "address1": "sample string 1",
    //         "address2": "sample string 2",
    //         "city": "sample string 3",
    //         "stateOrProvince": "sample string 4",
    //         "postalCode": "sample string 5",
    //         "phone": "sample string 6",
    //         "fax": "sample string 7",
    //         "country": "sample string 8"
    //       },
    //       "homeAddress": {},
    //       "loginStatus": "sample string 22",
    //       "passwordExpiration": "sample string 23",
    //       "lastLogin": "sample string 24",
    //       "sendActivationEmail": "sample string 25",
    //       "customSettings": [
    //         {}
    //       ],
    //       "profileImageUri": "sample string 26",
    //       "userProfileLastModifiedDate": "sample string 27",
    //       "signatureImageUri": "sample string 28",
    //       "initialsImageUri": "sample string 29",
    //       "jobTitle": "sample string 30"
    //     }
    //   ]
    // }

    CkJsonObjectW json;
    json.UpdateString(L"newUsers[0].userName",L"sample string 1");
    json.UpdateString(L"newUsers[0].userId",L"sample string 2");
    json.UpdateString(L"newUsers[0].userType",L"sample string 3");
    json.UpdateString(L"newUsers[0].isAdmin",L"sample string 4");
    json.UpdateString(L"newUsers[0].userStatus",L"sample string 5");
    json.UpdateString(L"newUsers[0].uri",L"sample string 6");
    json.UpdateString(L"newUsers[0].email",L"sample string 7");
    json.UpdateString(L"newUsers[0].password",L"sample string 8");
    json.UpdateString(L"newUsers[0].title",L"sample string 9");
    json.UpdateString(L"newUsers[0].createdDateTime",L"sample string 10");
    json.UpdateString(L"newUsers[0].firstName",L"sample string 11");
    json.UpdateString(L"newUsers[0].middleName",L"sample string 12");
    json.UpdateString(L"newUsers[0].lastName",L"sample string 13");
    json.UpdateString(L"newUsers[0].suffixName",L"sample string 14");
    json.UpdateString(L"newUsers[0].permissionProfileId",L"sample string 15");
    json.UpdateString(L"newUsers[0].permissionProfileName",L"sample string 16");
    json.UpdateString(L"newUsers[0].countryCode",L"sample string 17");
    json.UpdateString(L"newUsers[0].subscribe",L"sample string 18");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageUsers",L"sample string 1");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageAdmins",L"sample string 2");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageGroups",L"sample string 3");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageSharing",L"sample string 4");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageEnvelopeTransfer",L"sample string 5");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageAccountSettings",L"sample string 6");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageReporting",L"sample string 7");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageAccountSecuritySettings",L"sample string 8");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageSigningGroups",L"sample string 9");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageDocumentRetention",L"sample string 10");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canViewUsers",L"sample string 11");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageUsersMetadata.rights",L"sample string 1");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageUsersMetadata.uiHint",L"sample string 2");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageUsersMetadata.uiType",L"sample string 3");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageUsersMetadata.uiOrder",L"sample string 4");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageUsersMetadata.is21CFRPart11",L"sample string 5");
    json.UpdateString(L"newUsers[0].accountManagementGranular.canManageUsersMetadata.options[0]",L"sample string 1");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageAdminsMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageGroupsMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageSharingMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageEnvelopeTransferMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageAccountSettingsMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageReportingMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageAccountSecuritySettingsMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageSigningGroupsMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canManageDocumentRetentionMetadata");
    json.UpdateNewObject(L"newUsers[0].accountManagementGranular.canViewUsersMetadata");
    json.UpdateString(L"newUsers[0].sendActivationOnInvalidLogin",L"sample string 19");
    json.UpdateString(L"newUsers[0].activationAccessCode",L"sample string 20");
    json.UpdateString(L"newUsers[0].enableConnectForUser",L"sample string 21");
    json.UpdateString(L"newUsers[0].forgottenPasswordInfo.forgottenPasswordQuestion1",L"sample string 1");
    json.UpdateString(L"newUsers[0].forgottenPasswordInfo.forgottenPasswordAnswer1",L"sample string 2");
    json.UpdateString(L"newUsers[0].forgottenPasswordInfo.forgottenPasswordQuestion2",L"sample string 3");
    json.UpdateString(L"newUsers[0].forgottenPasswordInfo.forgottenPasswordAnswer2",L"sample string 4");
    json.UpdateString(L"newUsers[0].forgottenPasswordInfo.forgottenPasswordQuestion3",L"sample string 5");
    json.UpdateString(L"newUsers[0].forgottenPasswordInfo.forgottenPasswordAnswer3",L"sample string 6");
    json.UpdateString(L"newUsers[0].forgottenPasswordInfo.forgottenPasswordQuestion4",L"sample string 7");
    json.UpdateString(L"newUsers[0].forgottenPasswordInfo.forgottenPasswordAnswer4",L"sample string 8");
    json.UpdateString(L"newUsers[0].groupList[0].groupId",L"sample string 1");
    json.UpdateString(L"newUsers[0].groupList[0].groupName",L"sample string 2");
    json.UpdateString(L"newUsers[0].groupList[0].permissionProfileId",L"sample string 3");
    json.UpdateString(L"newUsers[0].groupList[0].groupType",L"sample string 4");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].userName",L"sample string 1");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].userId",L"sample string 2");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].email",L"sample string 3");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].userType",L"sample string 4");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].userStatus",L"sample string 5");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].uri",L"sample string 6");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].loginStatus",L"sample string 7");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].sendActivationEmail",L"sample string 8");
    json.UpdateString(L"newUsers[0].groupList[0].users[0].activationAccessCode",L"sample string 9");
    json.UpdateString(L"newUsers[0].workAddress.address1",L"sample string 1");
    json.UpdateString(L"newUsers[0].workAddress.address2",L"sample string 2");
    json.UpdateString(L"newUsers[0].workAddress.city",L"sample string 3");
    json.UpdateString(L"newUsers[0].workAddress.stateOrProvince",L"sample string 4");
    json.UpdateString(L"newUsers[0].workAddress.postalCode",L"sample string 5");
    json.UpdateString(L"newUsers[0].workAddress.phone",L"sample string 6");
    json.UpdateString(L"newUsers[0].workAddress.fax",L"sample string 7");
    json.UpdateString(L"newUsers[0].workAddress.country",L"sample string 8");
    json.UpdateNewObject(L"newUsers[0].homeAddress");
    json.UpdateString(L"newUsers[0].loginStatus",L"sample string 22");
    json.UpdateString(L"newUsers[0].passwordExpiration",L"sample string 23");
    json.UpdateString(L"newUsers[0].lastLogin",L"sample string 24");
    json.UpdateString(L"newUsers[0].sendActivationEmail",L"sample string 25");
    json.UpdateString(L"newUsers[0].profileImageUri",L"sample string 26");
    json.UpdateString(L"newUsers[0].userProfileLastModifiedDate",L"sample string 27");
    json.UpdateString(L"newUsers[0].signatureImageUri",L"sample string 28");
    json.UpdateString(L"newUsers[0].initialsImageUri",L"sample string 29");
    json.UpdateString(L"newUsers[0].jobTitle",L"sample string 30");

    // Adds the "Authorization: Bearer {{accessToken}}" header.
    http.put_AuthToken(L"{{accessToken}}");
    http.SetRequestHeader(L"Accept",L"application/json");

    CkHttpResponseW *resp = http.PostJson3(L"https://domain.com/v2.1/accounts/{{accountId}}/users",L"application/json",json);
    if (http.get_LastMethodSuccess() == false) {
        wprintf(L"%s\n",http.lastErrorText());
        return;
    }

    wprintf(L"%d\n",resp->get_StatusCode());
    wprintf(L"%s\n",resp->bodyStr());
    delete resp;
    }

Curl Command

curl -X POST
	-H "Accept: application/json"
	-H "Authorization: Bearer {{accessToken}}"
	-d '{
  "newUsers": [
    {
      "userName": "sample string 1",
      "userId": "sample string 2",
      "userType": "sample string 3",
      "isAdmin": "sample string 4",
      "userStatus": "sample string 5",
      "uri": "sample string 6",
      "email": "sample string 7",
      "password": "sample string 8",
      "title": "sample string 9",
      "createdDateTime": "sample string 10",
      "firstName": "sample string 11",
      "middleName": "sample string 12",
      "lastName": "sample string 13",
      "suffixName": "sample string 14",
      "permissionProfileId": "sample string 15",
      "permissionProfileName": "sample string 16",
      "countryCode": "sample string 17",
      "subscribe": "sample string 18",
      "userSettings": [
        {}
      ],
      "accountManagementGranular": {
        "canManageUsers": "sample string 1",
        "canManageAdmins": "sample string 2",
        "canManageGroups": "sample string 3",
        "canManageSharing": "sample string 4",
        "canManageEnvelopeTransfer": "sample string 5",
        "canManageAccountSettings": "sample string 6",
        "canManageReporting": "sample string 7",
        "canManageAccountSecuritySettings": "sample string 8",
        "canManageSigningGroups": "sample string 9",
        "canManageDocumentRetention": "sample string 10",
        "canViewUsers": "sample string 11",
        "canManageUsersMetadata": {
          "rights": "sample string 1",
          "uiHint": "sample string 2",
          "uiType": "sample string 3",
          "uiOrder": "sample string 4",
          "is21CFRPart11": "sample string 5",
          "options": [
            "sample string 1"
          ]
        },
        "canManageAdminsMetadata": {},
        "canManageGroupsMetadata": {},
        "canManageSharingMetadata": {},
        "canManageEnvelopeTransferMetadata": {},
        "canManageAccountSettingsMetadata": {},
        "canManageReportingMetadata": {},
        "canManageAccountSecuritySettingsMetadata": {},
        "canManageSigningGroupsMetadata": {},
        "canManageDocumentRetentionMetadata": {},
        "canViewUsersMetadata": {}
      },
      "sendActivationOnInvalidLogin": "sample string 19",
      "activationAccessCode": "sample string 20",
      "enableConnectForUser": "sample string 21",
      "forgottenPasswordInfo": {
        "forgottenPasswordQuestion1": "sample string 1",
        "forgottenPasswordAnswer1": "sample string 2",
        "forgottenPasswordQuestion2": "sample string 3",
        "forgottenPasswordAnswer2": "sample string 4",
        "forgottenPasswordQuestion3": "sample string 5",
        "forgottenPasswordAnswer3": "sample string 6",
        "forgottenPasswordQuestion4": "sample string 7",
        "forgottenPasswordAnswer4": "sample string 8"
      },
      "groupList": [
        {
          "groupId": "sample string 1",
          "groupName": "sample string 2",
          "permissionProfileId": "sample string 3",
          "groupType": "sample string 4",
          "users": [
            {
              "userName": "sample string 1",
              "userId": "sample string 2",
              "email": "sample string 3",
              "userType": "sample string 4",
              "userStatus": "sample string 5",
              "uri": "sample string 6",
              "loginStatus": "sample string 7",
              "sendActivationEmail": "sample string 8",
              "activationAccessCode": "sample string 9"
            }
          ]
        }
      ],
      "workAddress": {
        "address1": "sample string 1",
        "address2": "sample string 2",
        "city": "sample string 3",
        "stateOrProvince": "sample string 4",
        "postalCode": "sample string 5",
        "phone": "sample string 6",
        "fax": "sample string 7",
        "country": "sample string 8"
      },
      "homeAddress": {},
      "loginStatus": "sample string 22",
      "passwordExpiration": "sample string 23",
      "lastLogin": "sample string 24",
      "sendActivationEmail": "sample string 25",
      "customSettings": [
        {}
      ],
      "profileImageUri": "sample string 26",
      "userProfileLastModifiedDate": "sample string 27",
      "signatureImageUri": "sample string 28",
      "initialsImageUri": "sample string 29",
      "jobTitle": "sample string 30"
    }
  ]
}'
https://domain.com/v2.1/accounts/{{accountId}}/users

Postman Collection Item JSON

{
  "name": "Adds news user to the specified account.",
  "request": {
    "method": "POST",
    "header": [
      {
        "key": "Accept",
        "value": "application/json"
      },
      {
        "key": "Authorization",
        "value": "Bearer {{accessToken}}"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\n  \"newUsers\": [\n    {\n      \"userName\": \"sample string 1\",\n      \"userId\": \"sample string 2\",\n      \"userType\": \"sample string 3\",\n      \"isAdmin\": \"sample string 4\",\n      \"userStatus\": \"sample string 5\",\n      \"uri\": \"sample string 6\",\n      \"email\": \"sample string 7\",\n      \"password\": \"sample string 8\",\n      \"title\": \"sample string 9\",\n      \"createdDateTime\": \"sample string 10\",\n      \"firstName\": \"sample string 11\",\n      \"middleName\": \"sample string 12\",\n      \"lastName\": \"sample string 13\",\n      \"suffixName\": \"sample string 14\",\n      \"permissionProfileId\": \"sample string 15\",\n      \"permissionProfileName\": \"sample string 16\",\n      \"countryCode\": \"sample string 17\",\n      \"subscribe\": \"sample string 18\",\n      \"userSettings\": [\n        {}\n      ],\n      \"accountManagementGranular\": {\n        \"canManageUsers\": \"sample string 1\",\n        \"canManageAdmins\": \"sample string 2\",\n        \"canManageGroups\": \"sample string 3\",\n        \"canManageSharing\": \"sample string 4\",\n        \"canManageEnvelopeTransfer\": \"sample string 5\",\n        \"canManageAccountSettings\": \"sample string 6\",\n        \"canManageReporting\": \"sample string 7\",\n        \"canManageAccountSecuritySettings\": \"sample string 8\",\n        \"canManageSigningGroups\": \"sample string 9\",\n        \"canManageDocumentRetention\": \"sample string 10\",\n        \"canViewUsers\": \"sample string 11\",\n        \"canManageUsersMetadata\": {\n          \"rights\": \"sample string 1\",\n          \"uiHint\": \"sample string 2\",\n          \"uiType\": \"sample string 3\",\n          \"uiOrder\": \"sample string 4\",\n          \"is21CFRPart11\": \"sample string 5\",\n          \"options\": [\n            \"sample string 1\"\n          ]\n        },\n        \"canManageAdminsMetadata\": {},\n        \"canManageGroupsMetadata\": {},\n        \"canManageSharingMetadata\": {},\n        \"canManageEnvelopeTransferMetadata\": {},\n        \"canManageAccountSettingsMetadata\": {},\n        \"canManageReportingMetadata\": {},\n        \"canManageAccountSecuritySettingsMetadata\": {},\n        \"canManageSigningGroupsMetadata\": {},\n        \"canManageDocumentRetentionMetadata\": {},\n        \"canViewUsersMetadata\": {}\n      },\n      \"sendActivationOnInvalidLogin\": \"sample string 19\",\n      \"activationAccessCode\": \"sample string 20\",\n      \"enableConnectForUser\": \"sample string 21\",\n      \"forgottenPasswordInfo\": {\n        \"forgottenPasswordQuestion1\": \"sample string 1\",\n        \"forgottenPasswordAnswer1\": \"sample string 2\",\n        \"forgottenPasswordQuestion2\": \"sample string 3\",\n        \"forgottenPasswordAnswer2\": \"sample string 4\",\n        \"forgottenPasswordQuestion3\": \"sample string 5\",\n        \"forgottenPasswordAnswer3\": \"sample string 6\",\n        \"forgottenPasswordQuestion4\": \"sample string 7\",\n        \"forgottenPasswordAnswer4\": \"sample string 8\"\n      },\n      \"groupList\": [\n        {\n          \"groupId\": \"sample string 1\",\n          \"groupName\": \"sample string 2\",\n          \"permissionProfileId\": \"sample string 3\",\n          \"groupType\": \"sample string 4\",\n          \"users\": [\n            {\n              \"userName\": \"sample string 1\",\n              \"userId\": \"sample string 2\",\n              \"email\": \"sample string 3\",\n              \"userType\": \"sample string 4\",\n              \"userStatus\": \"sample string 5\",\n              \"uri\": \"sample string 6\",\n              \"loginStatus\": \"sample string 7\",\n              \"sendActivationEmail\": \"sample string 8\",\n              \"activationAccessCode\": \"sample string 9\"\n            }\n          ]\n        }\n      ],\n      \"workAddress\": {\n        \"address1\": \"sample string 1\",\n        \"address2\": \"sample string 2\",\n        \"city\": \"sample string 3\",\n        \"stateOrProvince\": \"sample string 4\",\n        \"postalCode\": \"sample string 5\",\n        \"phone\": \"sample string 6\",\n        \"fax\": \"sample string 7\",\n        \"country\": \"sample string 8\"\n      },\n      \"homeAddress\": {},\n      \"loginStatus\": \"sample string 22\",\n      \"passwordExpiration\": \"sample string 23\",\n      \"lastLogin\": \"sample string 24\",\n      \"sendActivationEmail\": \"sample string 25\",\n      \"customSettings\": [\n        {}\n      ],\n      \"profileImageUri\": \"sample string 26\",\n      \"userProfileLastModifiedDate\": \"sample string 27\",\n      \"signatureImageUri\": \"sample string 28\",\n      \"initialsImageUri\": \"sample string 29\",\n      \"jobTitle\": \"sample string 30\"\n    }\n  ]\n}"
    },
    "url": {
      "raw": "{{baseUrl}}/v2.1/accounts/{{accountId}}/users",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "v2.1",
        "accounts",
        "{{accountId}}",
        "users"
      ],
      "variable": [
        {
          "key": "accountId",
          "value": "{{accountId}}"
        }
      ]
    },
    "description": "Adds new users to your account. Set the `userSettings` property in the request to specify the actions the users can perform on the account."
  },
  "response": [
  ]
}