# Api · Settings · Admin Portal

Create API clients, assign their identifiers and choose the scopes that control endpoint access.

Canonical: https://docs.mintsd.com/docs/mint-service-desk/admin-portal-api
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a1452e-1d37-76fa-b69b-fc30d55697ba"></a>

View, create, edit and delete API clients for Mint Service Desk.

<a id="element-01a1452e-1d38-76da-89da-93a518038a3f"></a>

![Api: View, create, edit and delete API clients for Mint Service Desk.](https://docs.mintsd.com/api/reader/assets/assets/images/image555.png?v=ffbb70387cac4ed94ffea4ad19b5b61831b991f2f05aa7c0c866516f4fc187ba)

<a id="element-01a1452e-1d39-73ca-b68a-e4aacdb5fd43"></a>

<a id="element-01a1452e-1d39-7557-8feb-d89da7ff2ff4"></a>

To create a new API client, click on the ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452e-1d39-73ca-b68a-e4aacdb5fd43) button located on the
right side, next to the search field. You will be moved to the ‘API’
view where you need to fill some necessary data.

<a id="element-01a1452e-1d3a-769e-9c25-20da51ab3eda"></a>

![To create a new API client, click on the button located on the right side, next to the search field. You will be moved to the ‘API’ view where you need to fill some necessary data.](https://docs.mintsd.com/api/reader/assets/assets/images/image556.png?v=9af460666bef083b3ca3321f62a60dc7e5f2d2eb85e124bc2a772bdc5a1848a4)

<a id="element-01a1452e-1d3c-77a7-ad29-aea6fd878499"></a>

Enter the following required information:

<a id="element-01a1452e-1d3d-78a9-a220-c24dbaad7f10"></a>

- **‘Client id’** – API Client identifier,
- **‘Client name’** – API Client name.

<a id="element-01a1452e-1d3d-737c-baa7-974f0081deb7"></a>

Choose the client’s **‘Allowed scopes’**. These determine which endpoints it can access.

<a id="element-01a1452e-1d3e-7b6c-a91b-02d95c98bb92"></a>

![You also need to choose the desired scopes ( ‘Allowed scopes’ ). Those scopes specify the set of endpoints to which the API Client will also have access to.](https://docs.mintsd.com/api/reader/assets/assets/images/image557.png?v=e9b8490b95131fcb4b0f6c08b43b4bb3c7dc6b3e89f8b706940a7b1a9093b883)

<a id="element-01a1452e-1d3e-71dd-afa1-5b262524861e"></a>

In the Mint Service Desk, you have three available scopes to choose from:

<a id="element-01a1452e-1d40-74c9-b289-75761d81df32"></a>

- **‘mint_api.assets’** – gives access to edition and viewing the MINT
  Service Desk assets
- **‘mint_api.tickets’** – gives a possibility to view information
  about tickets, add comments and make other changes
- **‘mint_api.user_restricted (Require user)’** – adds additional
  possibilities to the scopes mentioned above. It unblocks, among
  others, creating tickets and adding new articles

<a id="element-01a1452e-1d40-7993-9de4-dc1376a1fed9"></a>

<a id="element-01a1452e-1d41-7e44-ac83-5435526a9d2d"></a>

If you select ‘mint api.assets’ and/or ‘mint api tickets’ you will be
able to save the new API Client. To do so just click the ![Create](https://docs.mintsd.com/api/reader/assets/assets/images/image58.png?v=3659f4ed6ae2729e35fe5eb8832cf827f8c264181610e981304daec839c30f99#element-01a1452e-1d40-7993-9de4-dc1376a1fed9)
button.

<a id="element-01a1452e-1d41-7c17-9899-724617bb51a5"></a>

- [Creating A Request](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-creating-a-request)
- [Creating A Bot User](https://docs.mintsd.com/docs/mint-service-desk/admin-portal-creating-a-bot-user)

