Skip to content

Check Telegram status

Poll this endpoint to check if a Telegram access code has been used to connect a channel/group. Recommended polling interval: 3 seconds. Status values: pending (waiting for user), connected (channel/group linked), expired (generate a new code).

PATCH /v1/connect/telegram

Poll this endpoint to check if a Telegram access code has been used to connect a channel/group. Recommended polling interval: 3 seconds. Status values: pending (waiting for user), connected (channel/group linked), expired (generate a new code).

Parameters

  • code (query, string) required — The access code to check status for

Responses

200 — Connection status

one of:

    • status (string) (enum: pending)
  • expiresAt (string)
  • expiresIn (integer) — Seconds until expiration
    • status (string) (enum: connected)
  • chatId (string)
  • chatTitle (string)
  • chatType (string) (enum: channel, group, supergroup)
  • account (object)
    • status (string) (enum: expired)
  • message (string)

401

404 — Code not found

500 — Internal error