---
title: "Link Telegram"
method: POST
path: "/cabinet/auth/account/link/telegram"
tags: ["Cabinet Account Linking"]
---

# Link Telegram

`POST /cabinet/auth/account/link/telegram`

Link Telegram account via WebApp initData, OIDC id_token, or Login Widget.

## Request body

- LinkTelegramRequest — Request for linking Telegram account. Supply EITHER init_data, id_token, OR widget fields.
  - `init_data` string, nullable — Telegram WebApp initData string
  - `id_token` string, nullable — Telegram OIDC id_token (JWT)
  - `id` integer, nullable — Telegram user ID from Login Widget
  - `first_name` string, nullable — User's first name
  - `last_name` string, nullable — User's last name
  - `username` string, nullable — User's username
  - `photo_url` string, nullable — User's photo URL
  - `auth_date` integer, nullable — Unix timestamp of authentication
  - `hash` string, nullable — Authentication hash (SHA-256 hex)

## Response `200`

Successful Response

- LinkCallbackResponse
  - `success` boolean, required
  - `message` string, nullable
  - `merge_required` boolean
  - `merge_token` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/bedolagam/apis/remnawave-bot-admin-api.md) · [All operations](https://skmtc.net/bedolagam/apis/remnawave-bot-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bedolagam/remnawave-bot-admin-api/revisions/45956d1b13ec/schema)