Skip to main content
POST
Link Telegram

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