API to create Hotspot Portal
API to create Hotspot Portal
Hello everyone.
I'm having issues with the API not creating a Authentication External Hotspot, no matter what i try
$ curl -k -X POST \
> -H "Authorization: AccessToken=$TOKEN" \
> -H "Content-Type: application/json" \
> "$BASE/portal" \
> -d '{
> "name": "xyz",
> "enable": true,
> "ssidList": ["68b12c1cfbb9f03b21757901","68b12c1cfbb9f03b21757902"],
> "networkList": [],
> "authType": 4,
> "authTimeout": { "customTimeout": 8, "customTimeoutUnit": 2 },
> "httpsRedirectEnable": true,
> "landingPage": 1,
> "landingUrlScheme": "http",
> "externalPortal": {
> "serverUrlScheme": "http",
> "serverUrl": "xyz"
> }
> }'
{"errorCode":-1001,"msg":"must not be null\n"}
The format is exactly as it is if i list the portal...
$ curl -k -H "Authorization: AccessToken=$TOKEN" \
> "$BASE/portal/$PORTAL_ID"
{"errorCode":0,"msg":"Success.","result":{"id":"68b17df8fbb9f03b21757932","name":"test","enable":true,"ssidList":["68b12c1cfbb9f03b21757901","68b12c1cfbb9f03b21757902"],"networkList":[],"authType":4,"authTimeout":{"authTimeout":5,"customTimeout":8,"customTimeoutUnit":2},"httpsRedirectEnable":true,"landingPage":1,"landingUrlScheme":"http","externalPortal":{"serverUrlScheme":"http","serverUrl":"xyz"}}}
I've tried adding the hostType too
curl -k -X POST \
-H "Authorization: AccessToken=$TOKEN" \
-H "Content-Type: application/json" \
"$BASE/portal" \
-d '{
"name": "xyz",
"enable": true,
"ssidList": ["68b0fc05fbb9f03b2175783f","68b0fc28fbb9f03b21757842"],
"authType": 4,
"authTimeout": { "authTimeout": 5, "customTimeout": 8, "customTimeoutUnit": 2 },
"httpsRedirectEnable": true,
"landingPage": 1,
"landingUrlScheme": "http",
"externalPortal": {
"hostType": 1,
"serverIp": "1.1.1.1",
"serverPort": 80,
"serverUrlScheme": "http"
}
}'
{"errorCode":-1001,"msg":"Parameter [portalCustomize] should not be null."}
This is the last step in my project to automate end to end
- Copy Link
- Subscribe
- Bookmark
- Report Inappropriate Content
@Vincent-TP [Omada Support Notification] Update on Your Support Ticket #49303 OpenAPI Issue
- Copy Link
- Report Inappropriate Content
@Vincent-TP did you find the case and verify the bug? i see there is a pre-release of version 6, but we will wait for stable
- Copy Link
- Report Inappropriate Content
Hi @icepicknz
Yes, I see the case. This should be fixed by the pre-release version.
Omada SDN Controller_V6.0.0.19 Pre-Release Firmware (released on 5th Sep, 2025)
You may install it and test if it worked. Thanks.
icepicknz wrote
@Vincent-TP did you find the case and verify the bug? i see there is a pre-release of version 6, but we will wait for stable
- Copy Link
- Report Inappropriate Content
@Vincent-TP i currently run v5.15.24.19 which appears to be the latest stable. Is the "SDN Controller" essentially the same product; i.e. not a different software product to the "Controler"?
Are there any concerns i should worry about with upgrading to version 6 if indeed the "SDN Controller" is the replacement from "Controller"?
I currently use the v5.15.24 API to manage devices; is anything removed or changed in vesion 6 that will stop working if i move from v5?
Many thanks in advance
- Copy Link
- Report Inappropriate Content
Hi @icepicknz
Omada’s Software Defined Networking (SDN) platform integrates network devices, including access points, switches, routers, and gateways to provide a 100% centralized management system. Omada creates a highly scalable network—all controlled from a single interface, the Omada SDN Controller., including these 3 different types: Software, Hardware, and Cloud-based.
For more details, you may refer to the following link:
The differences and commons of three Omada Controllers
I currently use the v5.15.24 API to manage devices; is anything removed or changed in vesion 6 that will stop working if i move from v5?
>>>Yes, compared to V5, V6 do have some changes. especially the VLAN config part. You may take sometime to review the following pre-release posts:
Omada SDN Controller_V6.0.0.x Pre-Release Firmware (Update on 28th Sep, 2025)
Hardware Controller (Built-in Omada SDN Controller V6.0.0) Pre-release (Release on 28th Sep)
- Copy Link
- Report Inappropriate Content
Information
Helpful: 0
Views: 595
Replies: 15
Voters 0
No one has voted for it yet.
