Create RadiusServer

POST

api

sys

radiusservers

Create RadiusServer

curl --request POST \
  --url https://spaces.nexudus.com/api/sys/radiusservers \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Name": "<string>",
  "Vendor": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/sys/radiusservers"

payload = {
    "BusinessId": 123,
    "Name": "<string>",
    "Vendor": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({BusinessId: 123, Name: '<string>', Vendor: 123})
};

fetch('https://spaces.nexudus.com/api/sys/radiusservers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

A RADIUS server is a hosted Wi-Fi authentication network that a location rents through the built-in provider integration, so customers sign in to the Wi-Fi with their Nexudus account and their network sessions become check-ins. Creating a record is not a settings change: the backend calls the provider to build a real network, a captive portal for the selected Vendor, and an authentication endpoint, then stores the returned network, portal, splash-page, IP, port and shared-secret values as read-only fields the operator copies into their wireless controller. It fails unless the location has a RADIUS licence key configured. Deleting a record deletes the network and captive portal at the provider and cannot be undone. Only the first active server of a location is used, an active server is billed monthly, and a server that is not active is skipped by the 15-minute synchronisation. The record alone does not grant anyone Wi-Fi access; that depends on each customer allowing network check-in and holding a pass that allows it.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the RadiusServer-Create role.

Enums

eRadiusServerVendor — Vendor values

Value	Name
0	Aerohive_Networks
1	Alcatel_Lucent
2	Aruba_Instant
3	Aruba_Mobility_Controller
4	Avaya
5	Bluesocket
6	Casa_Systems
7	ChilliSpot
8	CoovaChilli
9	Cisco_Systems
10	Dell
11	EnGenius
12	ExtremeWireless
13	FortiGate
14	ICC
15	LigoWave
16	Meraki_Sign_On
17	Meraki_ClickThrough
18	Meru_Networks
19	MikroTik
20	Motorola
21	Mojo_Networks
22	Open_Mesh_Cloudtrax
23	pfSense
24	Peplink
25	Ruckus_Wireless
26	Ruckus_Virtual_SZ
27	SonicWall
28	Ubiquiti_Networks
29	TP_Link_EAP
30	Trapeze_Wireless
31	Trendnet
32	Xirrus
33	Virtual_Controller
34	Other

Request Body

Required Fields

integer

required

ID of the location that owns this RADIUS server. The location’s RADIUS licence key setting decides whether the server can be provisioned at all, and its country selects the hosting region: US, AU, or Europe for everywhere else..

string

required

Operator-facing label for this server in the location’s list. The provider-side network and captive portal are named automatically from the location name and the creation date, so this value is not sent to the provider..

integer

required

Wireless hardware or controller the captive portal is built for, such as Meraki_Sign_On, Ubiquiti_Networks, MikroTik or Ruckus_Wireless; use Other when the vendor is not listed. It is applied only while the captive portal is provisioned during creation, so changing it afterwards does not rebuild the portal and the admin form disables it once the record exists..

Optional Fields

boolean

Whether this server is included in the RADIUS synchronisation that runs every 15 minutes to import provider accounting data as customer check-ins. Only the first active server of a location is used, and an active server also adds a RADIUS line to the location’s monthly invoice. Set false to stop syncing and billing without tearing down the provisioned network..

string

Optional free-text note about this server. It is not shown on the admin form and is not sent to the provider..

Code Examples

curl -X POST \
  "https://spaces.nexudus.com/api/sys/radiusservers" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Name": "",
    "Vendor": 0
}'

const response = await fetch(
  'https://spaces.nexudus.com/api/sys/radiusservers',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      BusinessId: 0,
      Name: '',
      Vendor: 0
    })
  }
);

const data = await response.json();

import requests

response = requests.post(
    'https://spaces.nexudus.com/api/sys/radiusservers',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    },
    json={
        'BusinessId': 0,
        'Name': '',
        'Vendor': 0
    }
)

data = response.json()

Response

200

integer

HTTP status code. 200 on success.

string

A human-readable message confirming the creation.

object

Contains the Id of the newly created record.

boolean

true if the radiusserver was created successfully.

array

null on success.

Example Response

{
  "Status": 200,
  "Message": "RadiusServer was successfully created.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

400

string

A summary of the validation error(s), in the format PropertyName: error message.

any

null on validation failure.

object[]

Array of validation errors.

Show child attributes

any

The value that was submitted for the field, or null if missing.

string

The validation error message.

string

The name of the property that failed validation.

boolean

false when the request fails validation.

Example Response

{
  "Message": "Name: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Name"
    }
  ],
  "WasSuccessful": false
}

Create RadiusServer

curl --request POST \
  --url https://spaces.nexudus.com/api/sys/radiusservers \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "BusinessId": 123,
  "Name": "<string>",
  "Vendor": 123
}
'

import requests

url = "https://spaces.nexudus.com/api/sys/radiusservers"

payload = {
    "BusinessId": 123,
    "Name": "<string>",
    "Vendor": 123
}
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
  body: JSON.stringify({BusinessId: 123, Name: '<string>', Vendor: 123})
};

fetch('https://spaces.nexudus.com/api/sys/radiusservers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Overview

Apps & Marketplace

Billing

Collaboration

Community

Content

CRM

Security

Spaces

Support

System

Authentication

Enums

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400

​Authentication

​Enums

​Request Body

​Required Fields

​Optional Fields

​Code Examples

​Response

​200

​400

Authentication

Enums

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400