Skip to main content
POST
/
v1
/
wifi-networks
Create a Wi-Fi Network
curl --request POST \
  --url https://managexrapi.com/v1/wifi-networks \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ssid": "AcmeCorpSecure",
  "nickname": "Office WiFi",
  "type": "WPA",
  "password": "password",
  "hidden": false,
  "disableMacRandomization": true
}'
{
  "data": {
    "id": "wifi_abc123",
    "ssid": "MyNetwork",
    "nickname": "Office Wi-Fi",
    "type": "WPA_ENTERPRISE"
  }
}

Authorizations

Authorization
string
header
required

API key based authentication where <encoded-value> is the Base64 encoding of API_KEY_ID:API_KEY_SECRET

  • Username: The API Key ID.
  • Password: The API Key Secret.

Query Parameters

organizationId
string

Unique identifier of the organization.
Defaults to the organization associated with the API key.

Body

application/json

Wi-Fi network credentials and information

ssid
string
required

Name of the Wi-Fi network to connect to.

Required string length: 2 - 32
type
enum<string>
required

Type of the network. Note, WPA is WPA2. WPA_ENTERPRISE is WPA2 Enterprise.

Available options:
OPEN,
WPA,
WPA_ENTERPRISE,
UNKNOWN
password
string

Password. Optional if the Wi-Fi type is OPEN.

nickname
string

Optional user-friendly label for the network.

hidden
boolean

Whether the network is hidden (SSID not broadcast).

disableMacRandomization
boolean

Whether to disable mac address randomization when this network is deployed on a device

eapMethod
enum<string>

Enterprise EAP method (PEAP, TLS, TTLS, etc).

Available options:
PEAP,
TLS,
TTLS,
PWD,
NONE
phase2Method
enum<string>

Inner authentication method used with the EAP method. Required for EAP methods PEAP and TTLS.

Available options:
PAP,
MSCHAP,
MSCHAPV2,
GTC,
NONE
identity
string

Identity used for enterprise network authentication. Required for WPA2-Enterprise network types.

anonymousIdentity
string

Anonymous identity used in outer identity requests. Required for EAP-PEAP and EAP-TTLS networks.

domain
string

Radius Server Domain. Required for EAP-PEAP, EAP-TLS, and EAP-TTLS WPA2-Enterprise networks on devices running Android 14 and above. This includes many of the latest Meta Quest and Pico devices. This field validates the certificate the server presents to the device, and prevents security vulnerabilities.

userCertificatePem
string

PEM-encoded user certificate, required for EAP-TLS networks.

caCertificatePem
string

PEM-encoded certificate authority certificate for server validation. Required for EAP-PEAP, EAP-TLS, and EAP-TTLS WPA2-Enterprise networks on devices running Android 14 and above. This includes many of the latest Meta Quest and Pico devices. Learn about certificate formatting

proxySettingType
enum<string>

Defines how proxy is configured: PAC, MANUAL, or NONE.

Available options:
PAC,
MANUAL,
NONE
proxyHost
string

Hostname or IP of the manual proxy server.

proxyPort
number

Port number of the manual proxy server.

Required range: 0 <= x <= 65535
proxyHostExclusionList
string[]

List of hostnames that bypass the proxy.

proxyPacUrl
string

URL to a PAC (proxy auto-config) file.

Response

The created wi-fi network

data
object

A Wi-Fi network profile summary

Example:
{
"id": "wifi_abc123",
"ssid": "MyNetwork",
"nickname": "Office Wi-Fi",
"type": "WPA_ENTERPRISE"
}
I