Skip to content
Mint Service Desk Documentation centre

Creating A Bot User

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

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.

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

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

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’.

Saving the secret

By default, the ‘Secret’ is hidden. To see its content, you need to click on the icon. Now write down, remember, or copy the ‘Secret’. You also can click the icon to copy the secret to your clipboard and paste it e.g., to some text editor.

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

Once you saved this secret just click button and API Client (with Bot user) will be created.

Managing the API client

After creating a new API Client, you can always either change anything inside it ( button) or even delete it from the system ( button).

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

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.

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.