Wire up your Integrations Page Using the Client SDK

With a valid token in place, you can now use the Client SDK to interact with MindCloud. In this step, we'll go through the functions of the SDK in order to guide you on how to build your integrations page.

List Integrations

You can get all available integrations using the following method:

const integrations = await mindCloud.getIntegrations();
console.log(integrations);

This information can be used to render your integrations page. See example integrations page for what this could look like.

Integrations return example:

[
  {
    "id": "int_SLACK_001", // integrationId
    "appId": "slk_12345ABCDE",
    "appName": "Slack",
    "companyId": "cmp_98765ZYXWV",
    "description": "Slack Messaging Platform",
    "iconUrl": "https://cdn.iconscout.com/icon/free/png-256/slack-226533.png",
    "isInstalled": true,
    "name": "Slack Integration",
    "createdOn": "2025-09-08T22:55:13.978Z",
    "updatedOn": "2025-09-08T22:55:14.718Z",
    "installations": [
      {
        "id": "install_123XYZ", // installationId
        "integrationId": "int_SLACK_001",
        "isInstalled": true,
        "createdOn": "2025-09-09T02:36:29.984122+00:00",
        "apps": [
          {
            "appId": "slk_12345ABCDE",
            "name": "Slack",
            "slug": "slack",
            "iconUrl": "https://cdn.iconscout.com/icon/free/png-256/slack-226533.png",
            "isConnected": true
          }
        ],
        "workflows": [
          {
            "id": "wf_67890",
            "name": "Send Slack Notification",
            "isInstalled": true, // enabled or disabled
            "arguments": {}
          }
        ]
      }
    ]
  }
]

Let’s break this down.

Installing an Integration

After display all the integrations in your UI, you can add a install button on each one. When clicking this button, you should open the SDK modal and it'll manage the credentials and settings for that integration. To open it, use this function:

mindCloud.install({
  integrationId, // id of the integration clicked on
});

Once the user selects what workflows to activate and connects their credentials we call this an Installation. It's not super common, but the same user can create multiple installations. Because of this, after an Installation is completed you must use its id to re-open the modal and be able to make changes.

Managing an Integration

When you fetch the integrations again, now you'll find an installations array inside the Integration object. To open the modal in edit mode for that installation, use the following code:

mindCloud.modify({
  installationId, // id of the current installation
});

This is the minimal code necessary to setup an integrations page in your system and let your users connect with Third-Party apps. For a full documentation of the SDK, click here.