# Create a new group for managing devices

Creation of group

## Endpoint

**POST** `/api/v1/mdm/groups`

## Request

### Request URL

`https://{server-hostname}:8383/api/v1/mdm/groups`

### Scope

`MDMDeviceMgmt.CREATE`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Content-Type** `string` **Mandatory**: `application/json`
- **Accept** `string` **Mandatory**: `application/json`

#### Request Body

`application/json`

- `name` `string` **Mandatory**: Name of the group. Must be unique within the customer
- `group_type` `integer` **Mandatory**: Type of group: 6 — Device Group, 7 — User Group/AD Group
- `domain` `string` Optional: Domain in which the group exists (applicable if Active Directory is synced)
- `description` `string` Optional: Description of the group

### Sample Request

```curl
curl --request POST \
  --url https://appdomain/api/v1/mdm/groups \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"domain":"ZYLKERCORP","name":"MDM","description":"Group for MDM","group_type":1}'
```

### Sample Request Body

#### Create a group with domain and description

```json
{
  "domain": "ZYLKERCORP",
  "name": "MDM",
  "description": "Group for MDM",
  "group_type": 1
}
```

#### Create a group with only required fields

```json
{
  "domain": "",
  "name": "Sales Devices",
  "description": "",
  "group_type": 1
}
```

## Response

### Response Parameters

#### HTTP Code 200

Response Body — `application/json`

- `group_id` `long`: Unique identifier for the newly created group
- `name` `string`: Name of the created group
- `group_type` `integer`: Type of group
- `domain` `string`: Domain in which the group exists
- `description` `string`: Description of the group

### Possible Response Codes

- **200** `HTTP code`

### Sample Response: HTTP 200

#### Group successfully created

```json
{
  "group_id": 99731238129,
  "domain": "ZYLKERCORP",
  "name": "MDM",
  "description": "Group for MDM",
  "group_type": 1
}
```

## API Rate Limit

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 300 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.