---
title: "Connect Telegram directly"
method: POST
path: "/v1/connect/telegram"
tags: ["Connect"]
---

# Connect Telegram directly

`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

- object
  - `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

## Response `200`

Telegram channel connected successfully

- object
  - `message` string
  - `account` object
    - `_id` string
    - `platform` 'telegram'
    - `username` string
    - `displayName` string
    - `isActive` boolean
    - `chatType` 'channel' | 'group' | 'supergroup' | 'private'

## Other responses

- `400` — Chat ID required, bot not admin, or cannot access chat
- `401` — Unauthorized
- `403` — No access to this profile
- `404` — Profile not found
- `500` — Internal error

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/f81ca70ea6b9/schema)