List the Telegram groups an org connected
Every group the org connected for its token gates, with the bot's rights there, whether it is the group's guard bot and how many people Synq manages, and the bot that serves the org on Telegram. Needs `org.integrations.view`.
/v1/orgs/{org}/telegram-groupsEvery group the org connected for its token gates, with the bot's rights there, whether it is the group's guard bot and how many people Synq manages, and the bot that serves the org on Telegram. Needs org.integrations.view.
Authorization
bearer An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.
In: header
Path Parameters
The org's id
^org_[0-9a-hjkmnp-tv-z]{26}$Query Parameters
At most this many items, 200 at the most.
1 <= value <= 20050The previous page's next_cursor, for the page after it.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/telegram-groups" \ -H "Authorization: Bearer $SYNQ_API_KEY"{ "data": [ { "id": "tgg_01h455vb4pex5vsknk084sn02q", "brand_id": "brd_01h455vb4pex5vsknk084sn02q", "chat_id": "-1001234567890", "title": "RODAI Holders", "username": "string", "kind": "group", "status": "connected", "guard_bot": true, "rights": { "invite_users": true, "restrict_members": true, "pin_messages": true }, "member_count": 0, "invite_link": "string", "own_bot": true, "listed": true, "listed_by": "brand", "counts": { "roles": 0, "gated": true, "managed": 0 }, "checked_at": "2026-10-21T12:00:00.000Z", "connected_at": "2026-10-21T12:00:00.000Z" } ], "next_cursor": "string", "bot": { "id": "1093847562019384756", "name": "Synq", "username": "SynqBot", "own": true }}Read a connected Telegram group GET
Needs `org.integrations.view`.
Change a connected Telegram group PATCH
Changes what is sent and keeps the rest. `listed`: whether the brand's member profile lists the group under Communities (null lists it): only with a way in, a public username, or join requests because a gate lets people in, so `true` with none is refused (400 at `listed`, with the fix). Needs `org.integrations.edit`. Recorded as `telegram_group.updated` with the fields changed.