Docs

Reference

List people

Search and filter CRM people (stage, tag, list, temperature, owner account). Offset paging.

View MarkdownThis page is generated from the source code on every release.

Search and filter CRM people (stage, tag, list, temperature, owner account). Offset paging.

Overview

Name Value
Code people.list
Scope needed crm.read
Risk Read
May need confirmation No
Runs as Answers right away
Needs Idempotency-Key No
Member roles allowed owner, manager, agent, viewer
In the app People → list

Input fields

Field Type Required Description
q text No
stageId uuid No
tag text No
listId uuid No
temperature "hot" | "warm" | "cold" No
ownerAccountId uuid No
limit integer No
offset integer No

Example request

curl -X POST https://tlg.builera.app/api/public/v2/ops/people.list \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Output fields (data)

Field Type Required
page null | text | number | object | any[] | true/false Yes
untrusted true Yes

Example answer

{
  "data": {
    "page": "text",
    "untrusted": true
  }
}

Using it over MCP

Tool people_list is listed on the profiles: Discover (prospecting). On other profiles, find it with tools_search and run it with tools_run.

Was this page helpful?

Last checked: 10/24/2026 · build 2.0