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:

https://connect.mindcloud.co/v1/universal/{appSlug}/{appVersion}/actions/{actionSlug}

Authenticate with your MindCloud API Key as a Bearer token and pass the connectionId for the account that should run the action. For read actions, pass it in the query string:

curl --request GET \
  --url "https://connect.mindcloud.co/v1/universal/slack/latest/actions/list-users" \
  --header "Authorization: Bearer $MINDCLOUD_API_KEY" \
  --get \
  --data-urlencode "connectionId=$CONNECTION_ID"

For create and update actions, pass connectionId in the JSON body alongside the action's arguments.

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.