# Create a new group for managing devices

Creation of group

## Endpoint

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

## Request URL

`https://[{serverurl}](https://www.manageengine.com/mobile-device-management/help/api/cloud/oauth-authentication-endpoint-domain.html)/api/v1/mdm/groups`

## Scope

`MDMOnDemand.MDMDeviceMgmt.CREATE`

## Header

`Authorization: Zoho-oauthtoken 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: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"name":"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 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 Limits

![](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.