Enable secure connections between your applications and Mindful services.

On the Application Clients page (API > Application Clients), you can generate unique OAuth 2.0 credentials containing Client IDs, Client Secrets, and API Keys to establish secure connections between your applications and Mindful services.

In most cases, the Mindful API requires integrations to authenticate using an Application Client, which consists of a Client ID and Client Secret, in order to obtain a short-lived token. This token is then used to validate subsequent requests made to the API. By creating multiple Application Clients, you can maintain distinct Client IDs and Client Secrets for each app that interacts with Mindful API endpoints.

To learn more about authenticating with the API using these values, see the Authentication guide. The remainder of this article describes the process of creating and editing Application Clients.

Create new Application Clients

Follow the steps below to create a new Application Client.

1. On the Application Clients page, click Add Application Client.

2. Enter a name and description for the new client.

3. Click Save when finished.

4. Copy the Client ID, Client Secret, and API Key that appear before moving on, and save these details somewhere outside of the Mindful UI.

Important: The Client Secret and API Key for the new Application Client will only be shown once! After saving a new client, only the Client ID can be viewed. When editing an existing Application Client, the credentials will be displayed like the following example:

Edit or delete Application Clients

To edit an existing Application Client's name or description, click the Edit icon in the appropriate row on the Application Clients page. You can also view the Client ID from the Edit page any time.

To delete an Application Client, click the Delete icon in the appropriate row.