Link Telegram

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

POST /cabinet/auth/account/link/telegram

Link Telegram

cURL

curl --request POST \
  --url https://api.example.com/cabinet/auth/account/link/telegram \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "init_data": "<string>",
  "id_token": "<string>",
  "id": 123,
  "first_name": "<string>",
  "last_name": "<string>",
  "username": "<string>",
  "photo_url": "<string>",
  "auth_date": 123,
  "hash": "<string>"
}
'

200

{
  "success": true,
  "message": "<string>",
  "merge_required": false,
  "merge_token": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request for linking Telegram account. Supply EITHER init_data, id_token, OR widget fields.

init_data · string | null

Telegram WebApp initData string

Maximum string length: 4096

id_token · string | null

Telegram OIDC id_token (JWT)

Maximum string length: 4096

id · integer | null

Telegram user ID from Login Widget

first_name · string | null

User's first name

Maximum string length: 256

last_name · string | null

User's last name

Maximum string length: 256

username · string | null

User's username

Maximum string length: 256

photo_url · string | null

User's photo URL

Maximum string length: 2048

auth_date · integer | null

Unix timestamp of authentication

hash · string | null

Authentication hash (SHA-256 hex)

Required string length: 64

Response

200

application/json

Successful Response

success · boolean · required

message · string | null

merge_required · boolean · default: false

merge_token · string | null