# Creating A Bot User · Api · Settings · Admin Portal

Create a bot account for API calls that require a user, then generate and manage the client’s secrets.

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

<a id="element-01a1452e-1db9-7d9c-a524-452df7c9c9e4"></a>

## Scope and bot account

While creating an API Client you can select the third ‘Allowed scope’:
**‘mint_api.user_restricted (Require user)’** from the list of
available scopes.

<a id="element-01a1452e-1dba-7119-aaaf-e98966577772"></a>

![While creating an API Client you can select the third ‘Allowed scope’: ‘mint_api.user_restricted (Require user)’ from the list of available scopes.](https://docs.mintsd.com/api/reader/assets/assets/images/image558.png?v=55d67b9b2081c125f3fae14b7daf26d1b6531d7e25b4cb6247d42f905c003d38)

<a id="element-01a1452e-1dbb-7895-a5bd-74d7ed699d57"></a>

This scope requires a Bot user. Requests that need a user are sent on behalf of that account.

<a id="element-01a1452e-1dbc-7e74-a923-a1a05c835c61"></a>

Selecting the scope opens the ‘Create bot user’ section.

<a id="element-01a1452e-1dbc-727b-bcd8-1ed92b92ff45"></a>

![Creating A Bot User: Selecting the scope opens the ‘Create bot user’ section.](https://docs.mintsd.com/api/reader/assets/assets/images/image559.png?v=ec27aee3146ac130e5f1355376721f273805ab348d0fe16a184d8f3f8381d6d9)

<a id="element-01a1452e-1dbe-71f2-b6df-43975e0a3e00"></a>

<a id="element-01a1452e-1dbe-70ba-8c67-51bfea8366d2"></a>

Now, you need to type ‘Email’ (the correct email address), ‘First name’
and ‘Surname’. Once you finish, click on the ![Create](https://docs.mintsd.com/api/reader/assets/assets/images/image58.png?v=3659f4ed6ae2729e35fe5eb8832cf827f8c264181610e981304daec839c30f99#element-01a1452e-1dbe-71f2-b6df-43975e0a3e00) button. You will
see an additional window ‘One-time secret’.

<a id="element-01a1452e-1dbf-77f2-9a90-124c4e1e0b48"></a>

![Now, you need to type ‘Email’ (the correct email address), ‘First name’ and ‘Surname’. Once you finish, click on the button. You will see an additional window ‘One-time secret’.](https://docs.mintsd.com/api/reader/assets/assets/images/image560.png?v=a0e5f56f150519cf14dbeb047a257062ecd9dc0aee12318126811094abff4c8f)

<a id="element-01a1452e-1dc1-7b93-903b-60d4ffe71045"></a>

<a id="element-01a1452e-1dc1-7a1a-9828-1dc7446d2e38"></a>

<a id="element-01a1452e-1dc2-75dc-8d68-82865090e137"></a>

## Saving the secret

By default, the ‘Secret’ is hidden. To see its content, you
need to click on the ![View](https://docs.mintsd.com/api/reader/assets/assets/images/image561.JPG?v=bc08e201eb2a5f725f096cdd35798de145a19d5c15b431e60e458ad275f929f9#element-01a1452e-1dc1-7b93-903b-60d4ffe71045) icon. Now write down, remember, or copy
the ‘Secret’. You also can click the ![Copy](https://docs.mintsd.com/api/reader/assets/assets/images/image562.JPG?v=fb25bed4a7a831cc2aacd0618fc0165b6ef41d65d62889200d1e9529328e1438#element-01a1452e-1dc1-7a1a-9828-1dc7446d2e38) icon to copy the secret
to your clipboard and paste it e.g., to some text editor.

<a id="element-01a1452e-1dc2-7785-8b00-b19076f0e90f"></a>

![By default, the ‘Secret’ is hidden. To see its content, you need to click on the button icon. Now write down, remember, or copy the ‘Secret’. You also can click the button icon to copy the secret to your clipboard and paste it e.g., to some text editor.](https://docs.mintsd.com/api/reader/assets/assets/images/image563.JPG?v=a8ca5c8ee11a8bbfb89786081a80d33a5a7e7c50e706f3a96461cb18b8aff76f)

<a id="element-01a1452e-1dc5-717d-baf4-1818822bb601"></a>

The secret is the key used by the calling web service.

<a id="element-01a1452e-1dc6-7831-bf8e-bef72d149dec"></a>

<a id="element-01a1452e-1dc7-764d-a0db-85890c534832"></a>

Once you saved this secret just click ![Ok](https://docs.mintsd.com/api/reader/assets/assets/images/image564.png?v=734ad4785297c7a424daa7d6a78173f1f7bd2d35e06ff04af475332da809641c#element-01a1452e-1dc6-7831-bf8e-bef72d149dec) button and API Client
(with Bot user) will be created.

<a id="element-01a1452e-1dc8-7ec9-9fb6-be8c5b506313"></a>

<a id="element-01a1452e-1dc8-71dd-851d-103b5abef9b6"></a>

<a id="element-01a1452e-1dc9-7de8-adbc-a3abd85f50b9"></a>

## Managing the API client

After creating a new API Client, you can always either change anything
inside it (![Edit](https://docs.mintsd.com/api/reader/assets/assets/images/image89.png?v=702adcf46ea452d46f158b0c91e923f5b40ae6f37d95ca5764e20654a2855c4c#element-01a1452e-1dc8-7ec9-9fb6-be8c5b506313) button) or even delete it from the system
(![Delete](https://docs.mintsd.com/api/reader/assets/assets/images/image202.png?v=1ae492635a6fc6619d5b242c62eff118e37d8d48440153360fc4ec4913f5ed3a#element-01a1452e-1dc8-71dd-851d-103b5abef9b6) button).

<a id="element-01a1452e-1dc9-7ec0-a77a-34550fe289d2"></a>

![After creating a new API Client, you can always either change anything inside it (button) or even delete it from the system (button).](https://docs.mintsd.com/api/reader/assets/assets/images/image565.png?v=8835a9180fc37d46984eb73ad4d04d4499991f093f94952a34a40cdddfad1a07)

<a id="element-01a1452e-1dca-7ef3-8528-5a5c1c6aa211"></a>

When editing an API client, use the ‘Secrets’ section on the right to view its registered secrets.

<a id="element-01a1452e-1dcb-7157-87f5-42e20bf3c7ba"></a>

![When editing an API client, use the ‘Secrets’ section on the right to view its registered secrets.](https://docs.mintsd.com/api/reader/assets/assets/images/image566.jpeg?v=9970e3779f822e0c4d4d90cb96d1cfbda8cb27aac8f25d3dcefa6b1c9d80b64f)

<a id="element-01a1452e-1dcb-7ddb-a1e2-d781a636567b"></a>

<a id="element-01a1452e-1dcc-7dd5-b05b-45abb43345aa"></a>

Here, you can generate a new secret. Simply click the ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image567.png?v=5f237536f1798d933a1ad54fc0faec0e8e32dbf9f373c1ddaf2458215e9c62fb#element-01a1452e-1dcb-7ddb-a1e2-d781a636567b) button
and copy/write down/memorize the secret just like you did when you were
creating a Bot user.

<a id="element-01a1452e-1dcd-72fe-88d6-2c50ee2ab3c1"></a>

![Here, you can generate a new secret. Simply click the button and copy/write down/memorize the secret just like you did when you were creating a Bot user.](https://docs.mintsd.com/api/reader/assets/assets/images/image568.JPG?v=721256ea18681d5f07855b07f2eabd125e7fb3ec2bf331f0109cb7660a3fcd60)

<a id="element-01a1452e-1dcd-7404-9b2f-342c23399503"></a>

<a id="element-01a1452e-1dce-7641-b378-6447e7f3d95f"></a>

You can also delete any of them by moving the mouse cursor over one
desired position. A new ![Close](https://docs.mintsd.com/api/reader/assets/assets/images/image569.png?v=07ab09e364979cb0eb46d89021824a6c53ef8c448abfcbd13470712836dbadb0#element-01a1452e-1dcd-7404-9b2f-342c23399503) button will appear. Just click on it
and the secret will be deleted.

<a id="element-01a1452e-1dcf-7f32-8027-1f5cb22b9dc4"></a>

![You can also delete any of them by moving the mouse cursor over one desired position. A new button will appear. Just click on it and the secret will be deleted.](https://docs.mintsd.com/api/reader/assets/assets/images/image570.png?v=7491dee2b57ad23f94724036ef83785da826c6461bce19e5289f679be6348ad0)

