Skip to main content
POST
/
cabinet
/
auth
/
account
/
link
/
telegram
Link Telegram
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>"
}
'
{
  "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

Successful Response

success
boolean
required
message
string | null
merge_required
boolean
default:false
merge_token
string | null