---
title: "Set Telegram Link"
method: PUT
path: "/api/channels/telegram"
tags: ["channels"]
---

# Set Telegram Link

`PUT /api/channels/telegram`

Link a Telegram user ID to the current user's account.

Creates or updates the ChannelRoute so inbound Telegram messages
from this ID are routed to this user. Returns 409 if the Telegram
user ID is already claimed by another account.

## Request body

- TelegramLinkRequest
  - `telegram_user_id` string, required

## Response `200`

Successful Response

- TelegramLinkResponse
  - `telegram_user_id` string, nullable, required
  - `connected` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/clawbolt.md) · [All operations](https://skmtc.net/mozilla-ai/apis/clawbolt/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/clawbolt/revisions/0e52fe5f8d33/schema)