# Add a new Wi-Fi payload configuration to an existing profile

To create Wifi policy

## Endpoint

`POST /api/v1/mdm/profiles/{profile_id}/payloads/wifipolicy`

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/profiles/{profile_id}/payloads/wifipolicy`

## Scope

`MDMDeviceMgmt.CREATE`

## Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

### Path Parameters

- **profile_id** — string — **Mandatory**

  Unique identifier of the profile. Obtain from the [Create Profile](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mdm-profiles-create-profile.html) or [Get Profiles](https://www.manageengine.com/products/desktop-central/help/api/onpremise/mdm-profiles-get-profile.html) response.

### Request Body

`application/json`

- **sub_config** — string — Optional

  Sub Config. Default: WIFI_NON_ENTERPRISE

- **service_set_identifier** — string — **Mandatory**

  Service Set Identifier

- **auto_join** — boolean — Optional

  Auto Join. Default: true

- **hidden_network** — boolean — **Mandatory**

  Hidden Network. Default: false

- **security_type** — integer — **Mandatory**

  WiFi security type. Allowed values: 0=None (Open), 1=WEP (Personal), 2=WPA/WPA2 (Personal), 3=Any (Personal), 4=WEP (Enterprise), 5=WPA/WPA2 (Enterprise), 6=Any (Enterprise), 7=WPA3 (Personal), 8=WPA3 (Enterprise)

- **wifi_non_enterprise** — JSON Object — Optional

  Wifi Non Enterprise

- **wifi_enterprise** — JSON Object — Optional

  Wifi Enterprise

- **proxy_type** — integer — Optional

  Proxy configuration type. Allowed values: 0=None, 1=Manual, 2=Automatic (PAC URL)

- **proxy_server** — string — Optional

  Proxy Server

- **proxy_server_port** — integer — Optional

  Proxy Server Port. Default: 0

- **proxy_user_name** — string — Optional

  Proxy User Name

- **proxy_password** — string — Optional

  Proxy Password (sensitive - write-only)

- **proxy_password_id** — long — Optional

  Proxy Password Id

- **proxy_pac_url** — string — Optional

  Proxy Pac Url

- **setup_modes** — integer — Optional

  WiFi setup mode. Allowed values: 1=System mode, 2=Login window mode, 3=Both system and login window

- **disable_mac_randomize** — boolean — Optional

  Disable Mac Randomize. Default: false

## Sample Request

```curl
curl --request POST \
  --url https://appdomain/api/v1/mdm/profiles/{profile_id}/payloads/wifipolicy \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52' \
  --header 'Content-Type: application/json' \
  --data '{"wifi_non_enterprise":{},"sub_config":"WIFI_NON_ENTERPRISE","wifi_enterprise":{},"proxy_server":"value","auto_join":true,"hidden_network":false,"proxy_server_port":0,"service_set_identifier":"value","security_type":3,"proxy_type":0}'
```

## Sample Request Body

Add Wi-Fi payload to the profile

```json
{
  "wifi_non_enterprise": {},
  "sub_config": "WIFI_NON_ENTERPRISE",
  "wifi_enterprise": {},
  "proxy_server": "value",
  "auto_join": true,
  "hidden_network": false,
  "proxy_server_port": 0,
  "service_set_identifier": "value",
  "security_type": 3,
  "proxy_type": 0
}
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- **payload_id** — long

  Unique identifier for the created payload item

- **sub_config** — string

  Sub Config. Default: WIFI_NON_ENTERPRISE

- **service_set_identifier** — string

  Service Set Identifier

- **auto_join** — boolean

  Auto Join. Default: true

- **hidden_network** — boolean

  Hidden Network. Default: false

- **security_type** — integer

  WiFi security type. Allowed values: 0=None (Open), 1=WEP (Personal), 2=WPA/WPA2 (Personal), 3=Any (Personal), 4=WEP (Enterprise), 5=WPA/WPA2 (Enterprise), 6=Any (Enterprise), 7=WPA3 (Personal), 8=WPA3 (Enterprise)

- **wifi_non_enterprise** — JSON Object

  Wifi Non Enterprise

- **wifi_enterprise** — JSON Object

  Wifi Enterprise

- **proxy_type** — integer

  Proxy configuration type. Allowed values: 0=None, 1=Manual, 2=Automatic (PAC URL)

- **proxy_server** — string

  Proxy Server

- **proxy_server_port** — integer

  Proxy Server Port. Default: 0

- **proxy_user_name** — string

  Proxy User Name

- **proxy_password** — string

  Proxy Password (sensitive - write-only)

- **proxy_password_id** — long

  Proxy Password Id

- **proxy_pac_url** — string

  Proxy Pac Url

- **setup_modes** — integer

  WiFi setup mode. Allowed values: 1=System mode, 2=Login window mode, 3=Both system and login window

- **disable_mac_randomize** — boolean

  Disable Mac Randomize. Default: false

## Possible Response Codes

- **200** — HTTP code

## Sample Response: HTTP 200

Wi-Fi payload successfully added

```json
{
  "payload_id": 9007199254741000,
  "wifi_non_enterprise": {},
  "sub_config": "WIFI_NON_ENTERPRISE",
  "wifi_enterprise": {},
  "proxy_server": "value",
  "auto_join": true,
  "hidden_network": false,
  "proxy_server_port": 0,
  "service_set_identifier": "value",
  "security_type": 3,
  "proxy_type": 0
}
```

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