Connect Telegram directly

Connect a Telegram channel/group directly using the chat ID. Alternative to the access code flow. The bot must already be an admin in the channel/group.

POST /v1/connect/telegram

Connect a Telegram channel/group directly using the chat ID. Alternative to the access code flow. The bot must already be an admin in the channel/group.

Request body

Content-Type: application/json

• chatId (string) required — The Telegram chat ID. Numeric ID (e.g. "-1001234567890") or username with @ prefix (e.g. "@mychannel").
• profileId (string) required — The profile ID to connect the account to

Example:

{
  "chatId": "-1001234567890",
  "profileId": "6507a1b2c3d4e5f6a7b8c9d0"
}

Responses

200 — Telegram channel connected successfully

• message (string)
• account (object)

400 — Chat ID required

401

403 — No access to this profile

404 — Profile not found

500 — Internal error