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

# Manage API Clients

## Intro

The API Clients feature in the Admin Settings allows you to create and manage your own API clients and allows admin users to manage all API clients for your instance. API Clients displays a list of clients with their scopes and allows you to revoke clients that are no longer needed.

***

## Required Grants

You must have ONE of the following grants to access the API Clients feature:

* **Create API OAuth Clients —** Allows you to view and revoke your own API clients. You must have this grant to create API clients.
* **(Admin-only) Manage All Access Tokens and API Clients —** Allows admins to view and revoke all API clients in your Domo instance.

This table highlights the differences between the grants.

| Access                                        | Create API  OAuth Clients                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Manage All Access Tokens and API Clients                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Create clients                                | <img alt="checkmark.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbAP.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=a22eb875556386f207f673a9f59a1fe8" style={{width: 35, height: 36, display: 'inline', verticalAlign: 'start', margin: '0'}} width="70" height="72" data-path="images/kb/0EMVq000004rbAP.jpg" /> | <img alt="red x.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbIT.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=bd05c4c24064db978aa87d44072dbfb4" style={{width: 32, height: 29, display: 'inline', verticalAlign: 'start', margin: '0'}} width="76" height="70" data-path="images/kb/0EMVq000004rbIT.jpg" />     |
| View clients you own                          | <img alt="checkmark.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbAP.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=a22eb875556386f207f673a9f59a1fe8" style={{width: 35, height: 36, display: 'inline', verticalAlign: 'start', margin: '0'}} width="70" height="72" data-path="images/kb/0EMVq000004rbAP.jpg" /> | <img alt="checkmark.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbAP.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=a22eb875556386f207f673a9f59a1fe8" style={{width: 35, height: 36, display: 'inline', verticalAlign: 'start', margin: '0'}} width="70" height="72" data-path="images/kb/0EMVq000004rbAP.jpg" /> |
| View all clients in the instance              | <img alt="red x.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbIT.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=bd05c4c24064db978aa87d44072dbfb4" style={{width: 32, height: 29, display: 'inline', verticalAlign: 'start', margin: '0'}} width="76" height="70" data-path="images/kb/0EMVq000004rbIT.jpg" />     | <img alt="checkmark.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbAP.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=a22eb875556386f207f673a9f59a1fe8" style={{width: 35, height: 36, display: 'inline', verticalAlign: 'start', margin: '0'}} width="70" height="72" data-path="images/kb/0EMVq000004rbAP.jpg" /> |
| Delete/revoke clients you create              | <img alt="checkmark.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbAP.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=a22eb875556386f207f673a9f59a1fe8" style={{width: 35, height: 36, display: 'inline', verticalAlign: 'start', margin: '0'}} width="70" height="72" data-path="images/kb/0EMVq000004rbAP.jpg" /> | <img alt="checkmark.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbAP.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=a22eb875556386f207f673a9f59a1fe8" style={{width: 35, height: 36, display: 'inline', verticalAlign: 'start', margin: '0'}} width="70" height="72" data-path="images/kb/0EMVq000004rbAP.jpg" /> |
| Revoke access for all clients in the instance | <img alt="red x.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbIT.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=bd05c4c24064db978aa87d44072dbfb4" style={{width: 32, height: 29, display: 'inline', verticalAlign: 'start', margin: '0'}} width="76" height="70" data-path="images/kb/0EMVq000004rbIT.jpg" />     | <img alt="checkmark.jpeg" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004rbAP.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=a22eb875556386f207f673a9f59a1fe8" style={{width: 35, height: 36, display: 'inline', verticalAlign: 'start', margin: '0'}} width="70" height="72" data-path="images/kb/0EMVq000004rbAP.jpg" /> |

## Access API Clients

Navigate to **Admin** > **Authentication** > **API Clients**.

<Frame>
  <img src="https://mintcdn.com/domoinc/3YSMssgLViHN46Fc/images/kb/0EMVq000007Rbp4.jpg?fit=max&auto=format&n=3YSMssgLViHN46Fc&q=85&s=c65d0097f00d22fd9d49bb9cb1a0f6ea" alt="Screenshot" width="2118" height="538" data-path="images/kb/0EMVq000007Rbp4.jpg" />
</Frame>

## Create API Clients

<Note>**Note:** While API clients can also currently be created in the [Domo developer portal](https://developer.domo.com) <img alt="external link icon.png" src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004oUwf.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=52ab4b749c6585b8258b8ec442ce074e" style={{width: 17, height: 17, display: 'inline', verticalAlign: 'start', margin: '0'}} width="20" height="20" data-path="images/kb/0EMVq000004oUwf.jpg" />, this functionality will be removed in the future.</Note>

Users with the Create API OAuth Clients [grant](#required-grants) can follow these steps to create a client:

1. [Access](#access-api-clients) the API Clients feature and select **Create** to open the creation modal.
2. In the modal, enter a unique name and description for your client. To facilitate proper client governance, pick a name and description that captures the planned usage of the API client.

   <Frame>
     <img src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004sne9.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=3c1f6eaf138a8280d1e6f7598314269a" alt="Screenshot 2025-01-17 at 11.55.54 AM.png" width="834" height="488" data-path="images/kb/0EMVq000004sne9.jpg" />
   </Frame>
3. Select which scopes you want to give the client.

<Note>**Note:** Domo recommends adhering to the principle of least privilege by giving your client only those scopes required by your use case.</Note>

<Frame>
  <img src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004smoY.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=7f11545df35c74781d9110418784685d" alt="Screenshot 2025-01-17 at 11.56.03 AM.png" width="826" height="1024" data-path="images/kb/0EMVq000004smoY.jpg" />
</Frame>

4\. Select **Create**. Upon confirmation, the ID and secret for your new client appear.
<Warning>**Important:** This is the only time the client secret displays.</Warning>

<Warning>**Warning:** The client ID and secret are highly sensitive because they grant access to your Domo instance. Treat these credentials in accordance with your organization's security policies.</Warning>

<Frame>
  <img src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004m6vF.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=936819f8c69384b15e885cab095b94d4" alt="Screenshot 2025-01-13 at 8.47.30 AM.png" width="590" height="681" data-path="images/kb/0EMVq000004m6vF.jpg" />
</Frame>

## View and Manage API Clients

The API Clients page lists active API clients in the Domo instance, depending on your [grants](#required-grants).

The list only displays partial client IDs, and the client secret is hidden to ensure security. The client's scope and owner are also displayed.

<Frame>
  <img src="https://mintcdn.com/domoinc/3YSMssgLViHN46Fc/images/kb/0EMVq000007RZk2.jpg?fit=max&auto=format&n=3YSMssgLViHN46Fc&q=85&s=6104881fdd2e8ee4bfe683a9a761a493" alt="Screenshot" width="2606" height="1008" data-path="images/kb/0EMVq000007RZk2.jpg" />
</Frame>

### Delete a Client

API clients can't be edited, but you can delete a client, depending on your [grants](#required-grants). To delete a client, follow these steps:

1. On the row for the client you want to delete, select <img alt="" src="https://mintcdn.com/domoinc/3YSMssgLViHN46Fc/images/kb/0EMVq000007Rchu.jpg?fit=max&auto=format&n=3YSMssgLViHN46Fc&q=85&s=cf37cf8e9c75db6254df53e596b18a42" style={{width: 24, height: 23, display: 'inline', verticalAlign: 'start', margin: '0'}} width="68" height="64" data-path="images/kb/0EMVq000007Rchu.jpg" />**More** (three vertical dots icon) > **Delete**.

   <Frame>
     <img src="https://mintcdn.com/domoinc/3YSMssgLViHN46Fc/images/kb/0EMVq000007ReII.jpg?fit=max&auto=format&n=3YSMssgLViHN46Fc&q=85&s=a94754a45634e885dbfa3316c83c63a0" alt="Screenshot" width="1754" height="704" data-path="images/kb/0EMVq000007ReII.jpg" />
   </Frame>
2. In the confirmation dialog, select **Revoke.**

   <Frame>
     <img src="https://mintcdn.com/domoinc/aLPJK5CyL2AKwzAg/images/kb/0EMVq000004mE1Z.jpg?fit=max&auto=format&n=aLPJK5CyL2AKwzAg&q=85&s=2fbc13a6c43653df67ab346d630d1e19" alt="Screenshot 2025-01-13 at 9.49.28 AM.png" width="405" height="332" data-path="images/kb/0EMVq000004mE1Z.jpg" />
   </Frame>

<Warning>**Important:** There is no warning dialog when you select **Revoke**—the client is removed. Ensure you are revoking the correct client, as this action cannot be undone. Note that existing sessions continue to be valid until they expire.</Warning>
