---
title: "Connect Telegram"
method: POST
path: "/api/projects/{project_id}/channels/telegram"
tags: ["projects"]
---

# Connect Telegram

`POST /api/projects/{project_id}/channels/telegram`

## Request

- Base URL: `https://api.maritime.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maritime.sh/api/projects/{project_id}/channels/telegram`
- Auth: HTTP bearer

Point a Telegram bot at this project: validate via getMe, register the
webhook, upsert the channel row. The bot becomes the project's front
door: end users DM it, the platform routes each chat to its instance.

## Path parameters

- `project_id` string, required

## Request body

- ConnectTelegramRequest
  - `botToken` string, required

## Response `200`

Successful Response

- ProjectChannelResponse
  - `id` string, required
  - `channelType` string, required
  - `botUsername` string, nullable
  - `webhookUrl` string, nullable
  - `enabled` boolean, required
  - `bindingCount` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/maritime/apis/maritime-api.md) - [All operations](https://skmtc.dev/maritime/apis/maritime-api/llms.txt) - [OpenAPI document](https://skmtc.dev/maritime/apis/maritime-api/revisions/acd712090ad6?raw)