Cloud Networking Management
Nebula Control Center
In September 2021, alongside the release of P12, Nebula introduced the initial version of Nebula OpenAPI, which serves as an interface for software to directly interact with the Nebula cloud platform and Nebula-managed devices. These APIs empower Nebula users to programmatically manage Nebula networks at scale through custom-developed applications. This page serves as an overview and FAQ document for Zyxel Nebula OpenAPI.
Nebula OpenAPI Overview
- Zyxel Nebula API is RESTful and HTTPS protected.
- Zyxel Nebula API uses API Key instead of OAUTH2 to authenticate.
- API key scope is per-Admin, and it shares the same permissions.
- For more basic introduction of Zyxel Nebula OpenAPI, please read this.
Support API List
You can find the latest version here, and as of now, the most recent version is 0.1.30
FAQ
Prerequisite:
Ensure your Nebula devices are registered under a Nebula Professional Pack licensed organization, as Nebula OpenAPI integration is exclusively available in the Pro Pack.
Generate API key in Nebula Control Center (NCC):
With the release of Nebula 18.20, Zyxel has greatly streamlined the API key management process, making it user-friendly, faster, and more secure. Users can now generate and regenerate API keys directly from the NCC. To generate a new API key, log into the NCC, and go to "API Key Management" under "My Devices and Services". Then follow the prompts to generate, acknowledge the security measures, copy, and save your key.

Please forward the ticket/case email to your local Zyxel sales or sales engineer to validate your feature request in terms of its impact on the business. This will assist the Nebula product management team in determining the priority of the request.
Before you begin, ensure that you have the following requirements in place:
- APP tool, such as Postman.
- API key.
Procedure:
- Go to the Postman website and sign up to create an account.
- After successfully signing in, go to the "My workspace" section. If you don't have a workspace, you can create a new one.
- Within the workspace, locate the "+" button, typically found at the top left of the interface, and click on it to proceed.
- Find the "Headers" section. Inside this section, you will see two columns labeled "Key" and "Value". In the "Key" field, enter "X-ZyxelNebula-API-Key". Then, in the corresponding "Value" field, paste the API key that you received from Zyxel support.
Reminder: The API key is tied to your account, so it’s essential to keep it secure and confidential, as it provides access to your organization. If you have any security concerns regarding your API key, don’t hesitate to contact Zyxel support to request a new API key and deactivate the old one. - Insert the API endpoint URL: https://api.nebula.zyxel.com/v1/nebula. After adding the endpoint URL, include the specific information you wish to retrieve. For instance, if you want to obtain the organization’s details such as:
- Name: Organization's name
- OrgId: Organization's unique ID
- Mode: Organization's license mode
The modified URL should appear as follows: https://api.nebula.zyxel.com/v1/nebula/organizations
Finally, click on the "Send" button to execute the request.
The response will present the results in the following format:
API token which located at Site-wide > Configure > Site settings is specifically used to generate an API token for DPPSK third-party integration.

To learn more about Nebula’s DPPSK solution and how to integrate it with a third-party WiFi onboarding management system, please visit our website.