SynqDocs
Management APIOwn bots

Set the org's own Telegram bot

A Telegram bot of the org's own serves the groups it connects (`POST …/telegram-groups/connect` with `own_bot: true`) in place of Synq's: its name and picture in the group and in what it writes to people. Checked with Telegram first (getMe; 400 at `token` with the fix, 503 when Telegram doesn't answer), its token sealed and never shown again, and its webhook pointed at Synq with a secret of its own. To be a group's guard bot, turn on join request queries for it in @BotFather. Sending the same bot again replaces its token; another bot can't replace one that still serves groups (409). Needs `org.integrations.edit` and a plan with `integration.own_bots` (Scale and up). Recorded as `own_bot.set`.

PUT/v1/orgs/{org}/own-bots/telegram

A Telegram bot of the org's own serves the groups it connects (POST …/telegram-groups/connect with own_bot: true) in place of Synq's: its name and picture in the group and in what it writes to people. Checked with Telegram first (getMe; 400 at token with the fix, 503 when Telegram doesn't answer), its token sealed and never shown again, and its webhook pointed at Synq with a secret of its own. To be a group's guard bot, turn on join request queries for it in @BotFather. Sending the same bot again replaces its token; another bot can't replace one that still serves groups (409). Needs org.integrations.edit and a plan with integration.own_bots (Scale and up). Recorded as own_bot.set.

Authorization

bearer
AuthorizationBearer <token>

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

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X PUT "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/own-bots/telegram" \  -H "Authorization: Bearer $SYNQ_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "token": "string"  }'
{  "id": "bot_01h455vb4pex5vsknk084sn02q",  "platform": "discord",  "external_id": "1203847562019384756",  "name": "Mollyverse Bot",  "username": "MollyverseBot",  "serves": 0,  "setup": {    "interactions_endpoint_url": "https://app.acme.example",    "redirect_uri": "https://app.acme.example",    "webhook_url": "https://app.acme.example"  },  "created_at": "2026-10-21T12:00:00.000Z",  "updated_at": "2026-10-21T12:00:00.000Z"}