Skip to main content

Creating an Environment

To add an environment:

  1. In the workspace where you added your collection, go to Environments in the workspace.

  2. Click Create Environment or click the Add icon.

    Alternatively, you can click the Environment quick look icon on the right panel from any location of the Postman application. A new environment is added and opens in a tab.

  3. On the environment tab, enter a descriptive name for the environment (e.g., OneAPI) where the current generic name is highlighted.

  4. In the variables table, add the variables listed in the following table and configure their values. For each variable, enter its value into the Initial value column, and the same value is automatically populated in the Current value column.

    The following table shows the variables and a description of their values:

    Variable NameDescription
    clientIDAPI client ID obtained from Authentication Service.
    clientSecretAPI client secret obtained from Authentication Service.
    customerIdZscaler Private Access (ZPA) tenant ID of the customer obtained from the Authentication Service or the ZPA. To learn how to obtain the ZPA customer ID, see Getting Started. This configuration is applicable only to ZPA API clients.
    oneAPIBaseUrlBase URL for OneAPI: https://api.zsapi.net.
    ZIABaseUrlBase URL for Zscaler Internet Access (ZIA) API: {{oneAPIBaseUrl}}/zia/api/v1.
    ZPABaseUrlBase URL for ZPA API: {{oneAPIBaseUrl}}/zpa.
    ZCCBaseUrlBase URL for Client Connector API: {{oneAPIBaseUrl}}/zcc/papi/public.
    ZTWBaseUrlBase URL for Cloud & Branch Connector API: {{oneAPIBaseUrl}}/ztw/api/v1.
    ZDXBaseUrlBase URL for Digital Experience (ZDX) API: {{oneAPIBaseUrl}}/zdx/v1.
    authServiceBaseUrlRepresents Authentication Service's token endpoint: https://<Vanity Domain>.zslogin.net, where <Vanity Domain> refers to the domain name used by your organization.
    ZIAMBaseUrlBase URL for Authentication Service API: {{oneAPIBaseUrl}}/ziam/admin/api/v1.
    ZBIBaseUrlThe base URL for Business Insights API: {{oneAPIBaseUrl}}/bi
    EASMBaseUrlThe base URL for EASM API: {{oneAPIBaseUrl}}/easm/easm-ui/v1
    AIInfrastructureBaseUrlThe base URL for AI Infrastructure endpoints of the AI Security API: {{oneAPIBaseUrl}}/aisecurity/aispm
    AIRedTeamingBaseUrlThe base URL for AI Red Teaming endpoints of the AI Security API: {{oneAPIBaseUrl}}/aisecurity/airt
    UrbacBaseUrlThe base URL for Unified RBAC API: {{oneAPIBaseUrl}}/urbac/urbac

    Ensure that the variables are selected, the Type is set to default, and that the variables are configured properly.

  5. Click Save in the top-right of the environment tab.