# Create API Token

Important Note:This article is for **Org Administrators** in particular. The actions discussed in the article are not available to general users. &#x20;

### Overview <a href="#overview" id="overview"></a>

An API token is a unique identifier of an application requesting access to your service. API tokens are used to authenticate requests to the ARM APIs.&#x20;

### Obtaining your Access Token  <a href="#obtaining-your-access-token" id="obtaining-your-access-token"></a>

You must have a unique personal access token to interact with the API. This is used to authenticate yourself in the API.&#x20;

Important Note:The token is the equivalent of the user name and password pair. Once generated, it identifies your account. So it's best to be careful and not disclose it to any untrusted party or application.

To generate your access token, you should:

1. Hover your mouse over the **`Admin`** tile and select the option: **`API Tokens.`**

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2F7DmLZb51Ve0nBrwDM4xc%2Fimage.png?alt=media&#x26;token=3a334780-1c4f-407f-9c1b-2240d38e2ab7" alt="" width="182"><figcaption></figcaption></figure>

2. Click on the **`Create API Token`** button to generate a new token.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FaTrAOtKG5Dk2gofgJ3Kc%2Fimage.png?alt=media&#x26;token=fce1a48a-96cd-48ef-85be-a0a1f6c8ebc6" alt="" width="563"><figcaption></figcaption></figure>

3. Enter the API **`Token Name`** on the next screen.&#x20;
4. Click **`Create`**.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2FvXLzIf8LnHGPcbfxAtJl%2Fimage.png?alt=media&#x26;token=531aca61-7729-4c9c-8a5f-d3a4ab4a5ec8" alt="" width="515"><figcaption></figcaption></figure>

5. Write down your newly generated token as you will need it soon.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fzj2oxTHdIsPI5268rYvp%2Fimage.png?alt=media&#x26;token=031e84a0-4eb7-47a7-a746-39adbbf708e0" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**Important Note:** For security reasons, viewing the token after closing the creation dialog is not possible. If necessary, create a new token. A maximum of 10 tokens are permitted for each user license. It is best to store the token securely, as with any password.
{% endhint %}

### Token Deactivation <a href="#token-deactivation" id="token-deactivation"></a>

If an ARM user account is deactivated, the API Token will be deactivated simultaneously. In some cases, ARM needs to revoke or invalidate tokens, for example, when a user logs out of the ARM application. If you revoke a token, it can be re-approved anytime before it expires.

<figure><img src="https://1912836914-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9vAxMuDrkUkB4OXlH9CL%2Fuploads%2Fv06G69Ur19m4Hdu7Pb64%2Fimage.png?alt=media&#x26;token=d797651b-a6d9-4e5a-9c6f-4c458843d2fa" alt="" width="563"><figcaption></figcaption></figure>
