Quickstart

This is the fastest path to a working request against any connected app. The request shape is identical across every app on the Universal API, so what you learn here applies everywhere.

Before you start

You need three things:

1. A MindCloud account. Sign in at MindCloud.
2. A MindCloud API Key. Create one in API Keys. Keep it on your server.
3. At least one app connection. Create or choose one in Connections. Note its connectionId.

Make your first request

Every action request uses the same URL pattern:

POST https://connect.mindcloud.co/v2/universal/apps/{appSlug}/actions/{actionSlug}/run

Authenticate with your MindCloud API Key as a Bearer token. Pass action arguments inside the arguments object.

curl --request POST "https://connect.mindcloud.co/v2/universal/apps/hubspot/actions/list-users/run" \
  --header "Authorization: Bearer $MINDCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"connectionId": "'"$CONNECTION_ID"'", "arguments": {"limit": 10}}'

You can omit connectionId when the app has a default connection.

What you get back

The Universal API returns the same envelope for every app — success, your data, and optional meta. The list-users call above comes back like this:

{
  "success": true,
  "data": [
    { "id": "U123", "name": "Ava" },
    { "id": "U456", "name": "Ben" }
  ]
}

data is always an array — even for actions that return a single record — so your code reads every app's response the same way.

What to read next

• Browse apps to find the app you want and open its actions.
• Pick an app, then read its Authentication and Arguments pages for the specifics of that app.