---
title: Add Tokens
slug: edgemanager/lem-admin-console/product-features/admin-console-settings/tokens/add-tokens
description: Learn how to add a token. 
docTags: 
createdAt: 2022-12-05T16:52:22.000Z
---

:::hint{type="info"}
**Note**: The Tokens feature is available for Litmus Edge Manager 2.7.0 and later.
:::

You can create a token from the **Settings** > **Tokens** pane. 

:::hint{type="warning"}
**Important**: After a token has been created, it can be viewed but no longer be modified.
:::

# Step 1: Create Token

**To create a new token:**

1. Log in to the Litmus Edge Manager (LEM) Admin Console at the following URL: **https\://\[LEM IP address]:8446**.
2. Navigate to **Settings** > **Tokens**.
3. Click the **Add New Token **icon.
   ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/71ytbOjjJlYv0guEwpJRv_2023-07-2409-23-19.png "Add New Token icon")

# Step 2: Enter Token Details

Enter the token name and select the expiration date for the token. 

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/pa-R87LTpczQHcTrop_GE_image.png "Token Details")

# Step 3: Define Token Scope

You will need to define what companies and projects the token can access. 

Make one of the following selections. 

## Administrator Scope

Selecting this will give the token instance administrator permissions, therefore giving access to all companies and projects. 

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/G5TMJFg6LRwYFKtc-UUe2_image.png "Administrator scope option")

## All Companies

Selecting this will give the token access to all companies and projects, but not instance administrator permissions. 

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/eMxRCbPHKaRtGHsiAIiYn_image.png "All Companies scope option")

## Custom Token Scope

Select individual companies to give the token access to all the projects for the company or select individual projects to the token access to. 

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/tp5bH0ciQmvKlFEACdOQA_image.png "Custom Token scope access")

# Step 4: Edge API Bridge Option

:::hint{type="info"}
**Note**: This option is available for Litmus Edge Manager version 2.15.0 and later. 
:::

Select this option to integrate all applicable Litmus Edge APIs through a single Litmus Edge Manager endpoint. 

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/GVZIwLSP-EeI7fx9zQ5hv_image.png "Edge API Bridge option")

The token has access to Litmus Edge APIs through: https\://\[LEM URL]/api/v1/edge/\{project-id}/\{edge-device-id}/\<edge-api-path>/\*

Do the following to retrieve these parameters:

- **project-id**: In the Litmus Edge Manager User UI, navigate to **Edge Devices** and click the device name you want to give access to. In the browser address bar, copy the string after the company name.&#x20;

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ORsdGNhM-fidICZ3AhHoX_image.png "Project ID parameter")

- edge-device-id: In the same browser address bar, copy the string after **device**.&#x20;

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/qSK1PdKp4g6btu7mHlYoh_image.png "Edge Device ID parameter")

# Step 5: Save Token



After saving the token, make sure to copy it before closing the dialog.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Czs2UE5zudsaPyKuPGg-r_new-token-created.png" size="60" width="552" height="299" position="center" caption="New token created [blurred token]" showCaption="true"}

# Use Token

When accessing the API, you must use the custom field `X-AuthToken` in the HTTP header.&#x20;

For example:&#x20;

`X-AuthToken: zZA82pIo70xzsrwmSl1f0P6DSfvuZgo1`