Docs

Reference

Saved groups

Saved Telegram groups with memberships per account and scan state (titles are untrusted).

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

Saved Telegram groups with memberships per account and scan state (titles are untrusted).

Overview

Name Value
Code groups.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 Discover → Groups

Input fields

This operation takes no fields.

Example request

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

Output fields (data)

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

Example answer

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

Using it over MCP

Tool groups_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