Creating a New Group
The CreateGroup function is used to create a new group. Groups can only belong to one account. Permissions are defined at the group level and users are then enrolled in groups.
GET/Remote/CreateGroup
REQUEST PARAMETERS
| Parameter | Type | Description | Required |
|---|---|---|---|
| mluser | string | Username - always in email form. | |
| mltoken -or- mlpass | string | MapLarge generated auth token -or- the password for the mluser account. | |
| account | string | The account that will own this group. | |
| groupname | string | The name to use for this group. | |
| description | string | A description to assign to this group. | |
| permissionlevel | string | The permission value of the group to be created. Values: admin, editor, viewer |
EXAMPLE REQUEST
https://my.maplarge.com/Remote/CreateGroup?mluser=user@domain.com&mltoken=token&groupname=testgroup2553&description=testdescription&account=test
*Either a token or password can be used in any request where authentication is required.
RETURNS
{ "id": "9da0c613bafc4c77bfb202645bfcbf2b", "hash": null, "success": true, "isCached": false, "authorized": true, "errors": [], "timestamp": 1420568624, "data": null, "groupid": 8562 }
ACTION SPECIFIC RESPONSE VALUES
| Parameter | Type | Description |
|---|---|---|
| groupid | long | The ID of the new group. |