# Create a new MDM profile

Create the profile based on the platform.

## Endpoint

**POST** `/api/v1/mdm/profiles`

## Request URL

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

## 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`

- `JSON object`
  - **profile_name** `string` — **Mandatory**
    - Name of the profile (required)
  - **profile_description** `string` — Optional
    - Description of the profile
  - **platform_type** `integer` — **Mandatory**
    - Profile platform type: 1 - iOS, 2 - Android, 3 - Windows, 4 - Chrome, 5 - MAC and 6 - Apple TV
  - **scope** `integer` — Optional
    - Scope of the profile (default - 0). Android: 0 - devices, 1 - knox container. Chrome: 0 - devices, 2 - user

## Sample Request

```curl
curl --request POST \
  --url https://appdomain/api/v1/mdm/profiles \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"profile_name":"IOS Restrictions Policy","platform_type":1}'
```

## Sample Request Body

### Create an iOS restrictions profile with default scope

```json
{
  "profile_name": "IOS Restrictions Policy",
  "platform_type": 1,
  "scope": 0,
  "profile_description": "Test IOS Restrictions Policy"
}
```

### Create an Android profile with Knox container scope

```json
{
  "profile_name": "Android Work Profile",
  "platform_type": 2,
  "scope": 1,
  "profile_description": "Android enterprise policy"
}
```

## Response Parameters

### HTTP code 200

Response Body — `application/json`

- `JSON object`
  - **profile_id** `long`
    - Unique identifier for the created profile
  - **profile_name** `string`
    - Name of the profile
  - **profile_description** `string`
    - Description of the profile
  - **platform_type** `integer`
    - Profile platform type: 1 - iOS, 2 - Android, 3 - Windows, 4 - Chrome, 5 - MAC and 6 - Apple TV
  - **scope** `integer`
    - Scope of the profile
  - **profile_version** `integer`
    - Current version of the profile
  - **profile_status** `string`
    - Status of the profile
  - **profile_status_id** `integer`
    - Status ID: 1 - Yet to Deploy, 110 - Published
  - **collection_id** `long`
    - Collection ID of the profile
  - **payloads** `array`
    - List of payload type names in the profile
  - **creation_time** `long`
    - Creation timestamp in milliseconds since epoch
  - **last_modified_time** `long`
    - Last modified timestamp in milliseconds since epoch
  - **created_by** `long`
    - User ID of the creator
  - **last_modified_by** `long`
    - User ID of the last modifier
  - **is_moved_to_trash** `boolean`
    - Whether the profile has been moved to trash

### Possible Response Codes

- **200** `HTTP code`

## Sample Response: HTTP 200

### Profile successfully created with initial metadata

```json
{
  "creation_time": 12312321312312,
  "last_modified_time": 213123213123,
  "profile_version": 1,
  "payloads": [],
  "last_modified_by": 213900719925474100000,
  "profile_description": "Test IOS Restrictions Policy",
  "created_by": 21321312312,
  "collection_id": 2132131231241,
  "profile_name": "IOS Restrictions Policy",
  "profile_status": "Yet To Deploy",
  "platform_type": 1,
  "is_moved_to_trash": false,
  "profile_id": 12321312312,
  "scope": 0,
  "profile_status_id": 1
}
```

## Rate Limit

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

**Duration:** 1 minute | **Threshold:** 30 | **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.