Search People

Finds people in Cloze.

GET

Query

Arguments

boolean

Filter by whether the person is assigned.

string

Filter by assignee email when assigned is true.

boolean

Return only the available count without person records.

string

Natural-language or UI-style Cloze query expression.

string

Group order for matching people.

number

Page number to retrieve, starting from 1.

number

Limit results per page. Default 10, maximum 1000.

string

Scope of matching relations, such as local or team. Set on the initial request.

string

Filter by segment id or current segment name.

string

Sort order for matching people.

string

Filter by person stage.

string

Filter by next step unique id.

Field selectionChoose which fields should be included in the response. Learn more

string

Comma-separated response fields to include.

Try this request

Request

curl --request GET \
  --url "https://connect.mindcloud.co/v1/universal/cloze/0.0.4/actions/search-people" \
  --header "Authorization: Bearer $MINDCLOUD_API_TOKEN" \
  --get \
  --data-urlencode 'connectionId=$CONNECTION_ID'

{
  "success": true,
  "data": [
    {
      "availablecount": 1,
      "errorcode": 1,
      "pagenumber": 1,
      "pagesize": 1,
      "people[]": {
        "assignee": "string",
        "direct": "string",
        "first": "string",
        "last": "string",
        "name": "Ava Chen",
        "segment": "string",
        "stage": "string"
      }
    }
  ],
  "meta": {}
}

Every app you connect,one REST pattern

Call any app with one REST pattern. MindCloud handles each provider's auth, request shape, and responses for you.

Learn what the Universal API is

One REST patternUse the same request structure across apps like Slack, HubSpot, Salesforce, and thousands more.

Managed connectionsSend a MindCloud connection ID instead of handling provider tokens, refresh logic, and credential storage yourself.

Action-level docsEach action page shows the exact endpoint, required arguments, optional controls, and response behavior for that app version.