POST groups

Creates a new root group.

Remarks

C4M Error Code returned:

null
The group has been created successfully.
GroupMustBeUnique
The group could not be created because there is another root group with the specified name.

HTTP Status returned:

403 - Forbidden
The authenticated user doesn't have permission to access the resource.

Request Information

Parameters

Name	Description	Additional information
requestDto	The group to create.	Define this parameter in the request body.

Request body formats

application/json, text/json

Sample:

{
  "name": "Developers"
}

Response Information

The newly created group.

Response body formats

application/json, text/json

Sample:

{
  "enrollCode": "sample string 1",
  "fullName": "sample string 2",
  "id": 3,
  "name": "sample string 4",
  "parentFullName": "sample string 5",
  "parentGroupId": 1
}

Sample:

{
  "devices": [
    {
      "activeApplicationId": 1,
      "alias": "MyDevice",
      "creationDate": "2020-05-15T17:03:27.6960553-03:00",
      "enabled": true,
      "groupId": 1,
      "hardwareId": "0123456789012345",
      "id": 3,
      "lastCommunication": "2020-05-15T17:03:27.6960553-03:00",
      "lastGroupChangeDate": "2020-05-15T17:03:27.6960553-03:00",
      "lockPassword": "sample string 4",
      "platform": 0
    },
    {
      "activeApplicationId": 1,
      "alias": "MyDevice",
      "creationDate": "2020-05-15T17:03:27.6960553-03:00",
      "enabled": true,
      "groupId": 1,
      "hardwareId": "0123456789012345",
      "id": 3,
      "lastCommunication": "2020-05-15T17:03:27.6960553-03:00",
      "lastGroupChangeDate": "2020-05-15T17:03:27.6960553-03:00",
      "lockPassword": "sample string 4",
      "platform": 0
    }
  ],
  "profiles": [
    {
      "composedProfileType": 0,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 11,
      "certificateSettings": {
        "certificateAuthorities": null,
        "certificateIdentities": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 10,
      "telephonySettings": {
        "accessPointNames": null,
        "defaultAccessPointName": null,
        "incomingCallWhitelist": null,
        "outgoingCallWhitelist": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 12,
      "wifiSettings": {
        "wifiNetworks": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 9,
      "settings": {
        "applications": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 3,
      "blacklist": {
        "applications": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 8,
      "settings": {
        "applications": null,
        "downloadMethod": 0
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 7,
      "settings": {
        "maximumFailedPasswordAttemptsForWipe": 0,
        "passwordExpirationTimeout": 0,
        "passwordHistoryLength": 0,
        "passwordMinimumLength": 0,
        "passwordMinimumLetters": 0,
        "passwordMinimumLowercase": 0,
        "passwordMinimumNonLetter": 0,
        "passwordMinimumNumeric": 0,
        "passwordMinimumSymbols": 0,
        "passwordMinimumUppercase": 0,
        "passwordQuality": 0
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 6,
      "policy": {
        "addUser": false,
        "adjustMasterVolume": false,
        "alwaysOnVpnPackage": null,
        "applicationAutoUpdatePolicy": 0,
        "autoTime": false,
        "bluetooth": false,
        "bluetoothConfiguration": false,
        "bluetoothContactSharing": false,
        "camera": false,
        "cellBroadcastsConfiguration": false,
        "credentialsConfiguration": false,
        "dataRoaming": false,
        "debuggingFeatures": false,
        "ensureVerifyApplications": false,
        "factoryReset": false,
        "forceHighAccuracy": false,
        "frpAdminEmails": null,
        "installApplications": false,
        "keyguardFeatures": null,
        "locationMode": 0,
        "lockScreenInfo": null,
        "maximumTimeToLock": 0,
        "microphone": false,
        "mobileNetworksConfiguration": false,
        "modifyAccounts": false,
        "mountPhysicalMedia": false,
        "networkReset": false,
        "outgoingBeam": false,
        "outgoingCalls": false,
        "permissionPolicy": 0,
        "permittedInputMethods": null,
        "playStoreMode": 0,
        "removeUser": false,
        "safeMode": false,
        "screenCapture": false,
        "sendReceiveSms": false,
        "skipFirstUseHints": false,
        "stayOnPluggedModes": null,
        "systemUpdatePolicy": 0,
        "tetheringConfiguration": false,
        "uninstallApplications": false,
        "untrustedApplicationsPolicy": 0,
        "usbFileTransfer": false,
        "vpnConfiguration": false,
        "wifiConfiguration": false,
        "windowedUpdateEndTime": 0,
        "windowedUpdateStartTime": 0
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 4,
      "launcherSettings": {
        "blockStatusBar": false,
        "enabled": false,
        "horizontalBackgroundImage": null,
        "lockTaskAllowed": false,
        "password": null,
        "passwordType": 0,
        "titleText": null,
        "verticalBackgroundImage": null,
        "whitelist": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "composedProfileType": 5,
      "policy": {
        "airplaneMode": false,
        "bluetooth": false,
        "camera": false,
        "clipboard": false,
        "factoryReset": false,
        "homeKey": false,
        "microphone": false,
        "nfc": false,
        "powerOff": false,
        "safeMode": false,
        "screenCapture": false,
        "settingsChanges": false,
        "statusBarExpansion": false,
        "taskManager": false,
        "wifi": false
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "applicationSettings": {
        "applications": null
      },
      "composedProfileType": 2,
      "policy": {
        "airplaneMode": false,
        "audioRecord": false,
        "bluetooth": false,
        "camera": false,
        "clipboard": false,
        "clipboardShare": false,
        "factoryReset": false,
        "headphone": false,
        "homeKey": false,
        "microphone": false,
        "navigationBar": false,
        "nfc": false,
        "otaUpgrade": false,
        "powerOff": false,
        "safeMode": false,
        "screenCapture": false,
        "settingsChanges": false,
        "softwareInstallation": false,
        "softwareUninstallation": false,
        "statusBar": false,
        "statusBarExpansion": false,
        "sVoice": false,
        "taskManager": false,
        "videoRecord": false,
        "wifi": false
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    },
    {
      "applicationUsage": {
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "battery": {
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "composedProfileType": 0,
      "dataUsage": {
        "beginOfCycle": null,
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "location": {
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "locationHistory": {
        "monitoringQuality": null,
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "memory": {
        "enabled": false,
        "monitoringInterval": null,
        "storageTime": null,
        "synchronizationInterval": null
      },
      "groups": null,
      "isReadOnly": false,
      "description": "Sample profile description.",
      "id": 1,
      "name": "Sample profile"
    }
  ],
  "subgroups": [
    {
      "devices": null,
      "profiles": null,
      "subgroups": null,
      "enrollCode": "sample string 1",
      "fullName": "sample string 2",
      "id": 3,
      "name": "sample string 4",
      "parentFullName": "sample string 5",
      "parentGroupId": 1
    },
    {
      "devices": null,
      "profiles": null,
      "subgroups": null,
      "enrollCode": "sample string 1",
      "fullName": "sample string 2",
      "id": 3,
      "name": "sample string 4",
      "parentFullName": "sample string 5",
      "parentGroupId": 1
    }
  ],
  "enrollCode": "sample string 1",
  "fullName": "sample string 2",
  "id": 3,
  "name": "sample string 4",
  "parentFullName": "sample string 5",
  "parentGroupId": 1
}