Skip to main content

​
Overview

To authenticate with Juniper Mist, you will need:
  1. API Subdomain - The API subdomain for your Juniper Mist region
  2. API Token - Your Juniper Mist API token (personal or organization token) for authentication.
This guide will walk you through finding your API subdomain and generating your API Token within Juniper Mist. You can use either a personal API token (user token) or an organization API token:
  • Personal API tokens: For individual user access
  • Organization API tokens: For automated systems and service accounts

​
Prerequisites:

  • You must have a Juniper Mist account

​
Instructions:

​
Step 1: Finding your API Subdomain

  1. Log in to the Juniper Mist portal.
  2. Once logged in, check the address bar. Notice the first part of the URL, starting with the word manage and ending with com. Example: https://manage.ac2.mist.com/admin/?org_id=xxxxxxx-xxxx-xxx
  3. Your API endpoint is similar but starts with api instead of manage. In the above example, the resulting API subdomain is api.ac2. Tip: The portal URL also contains your organization ID. In the URL, the organization ID section starts with these characters: org_id=
List of API Endpoint URLs by Region:
RegionAdmin PortalAPI Subdomain
Global 01manage.mist.comapi
Global 02manage.gc1.mist.comapi.gc1
Global 03manage.ac2.mist.comapi.ac2
Global 04manage.gc2.mist.comapi.gc2
Global 05manage.gc4.mist.comapi.gc4
EMEA 01manage.eu.mist.comapi.eu
EMEA 02manage.gc3.mist.comapi.gc3
EMEA 03manage.ac6.mist.comapi.ac6
EMEA 04manage.gc6.mist.comapi.gc6
APAC 01manage.ac5.mist.comapi.ac5
APAC 02manage.gc5.mist.comapi.gc5
APAC 03manage.gc7.mist.comapi.gc7

​
Step 2: Generating your API Token

Choose one of the following methods based on your needs: Option A: Generate a Personal API Token (User Token)
  1. Sign in to your Juniper Mist portal.
  2. At the top-right corner, click the Juniper Mist Account icon, then click My Account.
  1. In the API Token section, click Create Token.
    • Note: If you have enabled single sign-on for your organization, you will not be able to create API user tokens.
  1. Enter a name for the token and click Generate.
  2. Click the copy button next to the Key field to copy your token.
  1. Important: Store the key somewhere safe as you will not be able to see the full key again. If you misplace the key, you’ll need to create a new one.
  2. Click Done.
Option B: Generate an Organization API Token
  1. Sign in to your Juniper Mist portal.
  2. From the left menu, navigate to Organization > Settings.
  1. Scroll down to the API Token section and click Create Token.
  1. Define the permissions for the token.
  2. Click Generate.
  3. After clicking Generate, you will see a message at the top of the window reminding you to save your key.
  4. Click the copy button next to the Key field to copy your token.
  1. Important: Store the key somewhere safe. The only time you will see the entire, untruncated key is upon creation. You will not be able to see the full key ever again. If you misplace the key, you will have to create a new key.
  2. Click Done at the bottom of the window.
  3. Click Save near the top-right corner of the page.

​
Step 3: Enter credentials in the Connect UI

Once you have your API Subdomain and API Token:
  1. Open the form where you need to authenticate with Juniper Mist.
  2. Enter your API Subdomain (e.g., api, api.gc1, api.ac2) in the respective field.
  3. Enter your API Token in the respective field.
  4. Submit the form, and you should be successfully authenticated.
You are now connected to Juniper Mist.