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

Information
Helpful: 0
Views: 323
Replies: 13
Voters 0
No one has voted for it yet.