> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orum.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> Obtain credentials and get started with Orum’s APIs

## Overview

Orum’s Authentication API requires users to create a set of API Credentials to generate an auth token. Users can create and manage API Credentials directly within Monitor. See below for steps to obtain a set of API Credentials to generate your Auth token.

<iframe width="100%" height="315" src="https://www.loom.com/embed/dba633d0f248415d8b7f08d4aa37e497" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />

### API Credentials

API Credentials are specified within the body of the Orum Auth API call. These credentials can be created and deleted within the “API Authentication” page. See the screenshots below for the full flow:

<Frame caption="Creating new API Credentials">
  <img src="https://mintcdn.com/orum/ecbhl-TyW6xIdXPn/images/guides/32f0f7cc3c62a6b025c3592c83ef0fa7a38f070203189479c340f3fd85af0916-c6e04a4-Screenshot_2024-08-19_at_2.41.13_PM.png?fit=max&auto=format&n=ecbhl-TyW6xIdXPn&q=85&s=1553afd3aacb429e183c6759d3aee95e" alt="" width="2638" height="1220" data-path="images/guides/32f0f7cc3c62a6b025c3592c83ef0fa7a38f070203189479c340f3fd85af0916-c6e04a4-Screenshot_2024-08-19_at_2.41.13_PM.png" />
</Frame>

<Frame caption="Naming your API credentials (must be unique)">
  <img src="https://mintcdn.com/orum/ecbhl-TyW6xIdXPn/images/guides/b779b83aa0798933726913bcab863bf412ae6f54440234fd4308ec21f6008140-dab5421-Screenshot_2024-08-19_at_2.41.33_PM.png?fit=max&auto=format&n=ecbhl-TyW6xIdXPn&q=85&s=682e0ece7a1178f305849317440a38c9" alt="" width="2640" height="1144" data-path="images/guides/b779b83aa0798933726913bcab863bf412ae6f54440234fd4308ec21f6008140-dab5421-Screenshot_2024-08-19_at_2.41.33_PM.png" />
</Frame>

<Frame caption="Generating new API credentials">
  <img src="https://mintcdn.com/orum/ecbhl-TyW6xIdXPn/images/guides/f653b83ae2c1872dc227f32cb3f88f54988c10b4df97a34d012b9a5f1e5e67df-04a7d6c-Screenshot_2024-08-19_at_2.43.34_PM.png?fit=max&auto=format&n=ecbhl-TyW6xIdXPn&q=85&s=8cb12869ce122b3ab1087c135023165d" alt="" width="2083" height="992" data-path="images/guides/f653b83ae2c1872dc227f32cb3f88f54988c10b4df97a34d012b9a5f1e5e67df-04a7d6c-Screenshot_2024-08-19_at_2.43.34_PM.png" />
</Frame>

**Note:**

* These credentials are **NOT** connected to your Monitor login and password. They are created and to be managed separately.
* These credentials are **NOT** needed for any other API call — they are only used to generate an auth token.
* There is a **maximum of two** API Credentials per Enterprise per environment.
* Once you retrieve your `client_secret` store it in a secure location as you will not be able to retrieve it again. If you lose the original one or want to `rotate` your api credentials, you must generate a new set of credentials and delete the original one. **Only delete the original one after you have changed all authentication to use the new secret** as deleting a client will result in immediate failure of authentication requests with those credentials.

### Obtaining an auth token

Use the credentials generated in the step above to request a token from the [/oauth/token endpoint](/api-reference/auth/post-oauth-token).
