> ## Documentation Index
> Fetch the complete documentation index at: https://docs.managexr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Wi-Fi Network

> Add a new Open, WPA2 or WPA2-Enterprise Wi-Fi network to your Library




## OpenAPI

````yaml Post /v1/wifi-networks
openapi: 3.1.0
info:
  title: ManageXR API
  description: API documentation for ManageXR
  version: 1.0.0
servers:
  - url: https://managexrapi.com
    description: ManageXR API Server
security:
  - basicAuth: []
paths:
  /v1/wifi-networks:
    post:
      summary: Create a Wi-Fi Network
      description: |
        Add a new Open, WPA2 or WPA2-Enterprise Wi-Fi network to your Library
      parameters:
        - name: organizationId
          in: query
          required: false
          schema:
            type: string
          description: >
            Unique identifier of the organization. This parameter is only
            necessary when using multi-organization API keys. 


            Defaults to the organizationId associated with the API key.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateWifiNetworkDto'
              type: object
              description: Wi-Fi network credentials and information
      responses:
        '200':
          description: The created wi-fi network
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/V1WifiNetwork'
                    type: object
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 400
                  message:
                    type: string
                    example: Password must be set for this network type.
                  error:
                    type: string
                    example: ManageXR Error
              example:
                statusCode: 400
                message: Password must be set for this network type.
                error: ManageXR Error
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                    example: 403
                  message:
                    type: string
                    example: Forbidden
                  error:
                    type: string
                    example: ManageXR Error
              example:
                statusCode: 403
                message: Forbidden
                error: ManageXR Error
components:
  schemas:
    CreateWifiNetworkDto:
      type: object
      properties:
        ssid:
          type: string
          minLength: 2
          maxLength: 32
          description: Name of the Wi-Fi network to connect to.
        password:
          type: string
          description: Password. Optional if the Wi-Fi type is OPEN.
        nickname:
          type: string
          description: Optional user-friendly label for the network.
        type:
          $ref: '#/components/schemas/WifiNetworkType'
          description: >-
            Type of the network. Note, WPA is WPA2. WPA_ENTERPRISE is WPA2
            Enterprise.
        hidden:
          type: boolean
          description: Whether the network is hidden (SSID not broadcast).
        disableMacRandomization:
          type: boolean
          description: >-
            Whether to disable mac address randomization when this network is
            deployed on a device
        eapMethod:
          $ref: '#/components/schemas/EapMethod'
          description: Enterprise EAP method (PEAP, TLS, TTLS, etc).
        phase2Method:
          $ref: '#/components/schemas/Phase2Method'
          description: >-
            Inner authentication method used with the EAP method. Required for
            EAP methods PEAP and TTLS.
        identity:
          type: string
          description: >-
            Identity used for enterprise network authentication. Required for
            WPA2-Enterprise network types.
        anonymousIdentity:
          type: string
          description: >-
            Anonymous identity used in outer identity requests. Required for
            EAP-PEAP and EAP-TTLS networks.
        domain:
          type: string
          description: >-
            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:
          type: string
          description: PEM-encoded user certificate, required for EAP-TLS networks.
        caCertificatePem:
          type: string
          description: >-
            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](https://help.managexr.com/en/articles/7131251-deploying-enterprise-wi-fi-certificates-on-managexr)
        proxySettingType:
          $ref: '#/components/schemas/ProxySettingType'
          description: 'Defines how proxy is configured: PAC, MANUAL, or NONE.'
        proxyHost:
          type: string
          description: Hostname or IP of the manual proxy server.
        proxyPort:
          type: number
          minimum: 0
          maximum: 65535
          description: Port number of the manual proxy server.
        proxyHostExclusionList:
          type: array
          items:
            type: string
          description: List of hostnames that bypass the proxy.
        proxyPacUrl:
          type: string
          description: URL to a PAC (proxy auto-config) file.
      required:
        - ssid
        - type
      example:
        ssid: AcmeCorpSecure
        nickname: Office WiFi
        type: WPA
        password: password
        hidden: false
        disableMacRandomization: true
    V1WifiNetwork:
      type: object
      description: A Wi-Fi network profile summary
      properties:
        id:
          type: string
          description: Unique identifier of the Wi-Fi network
          example: wifi_abc123
        ssid:
          type: string
          description: The SSID (name) of the Wi-Fi network
          example: MyNetwork
        nickname:
          type: string
          description: A user-defined label for the network
          example: Office Wi-Fi
        type:
          type: string
          description: The security type of the network
          enum:
            - OPEN
            - WPA
            - WPA_ENTERPRISE
            - WPA3
            - WPA3_ENTERPRISE
            - UNKNOWN
          example: WPA_ENTERPRISE
        priorityWifiNetwork:
          type: boolean
          description: >-
            Priority network. The device will always connect to this network
            over other networks when it is in range and available.
          example: false
      example:
        id: wifi_abc123
        ssid: MyNetwork
        nickname: Office Wi-Fi
        type: WPA_ENTERPRISE
        priorityWifiNetwork: false
    WifiNetworkType:
      type: string
      enum:
        - OPEN
        - WPA
        - WPA_ENTERPRISE
        - WPA3
        - WPA3_ENTERPRISE
        - UNKNOWN
    EapMethod:
      type: string
      enum:
        - PEAP
        - TLS
        - TTLS
        - PWD
        - NONE
    Phase2Method:
      type: string
      enum:
        - PAP
        - MSCHAP
        - MSCHAPV2
        - GTC
        - NONE
    ProxySettingType:
      type: string
      enum:
        - PAC
        - MANUAL
        - NONE
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >
        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.

````