Skip to main content

Mint a single-use Telegram connect link for the caller

POST 
/api/v1/orgs/:org/users/me/telegram/link

Returns a https://t.me/<botUsername>?start=<token> deep link carrying a single-use, high-entropy token (TTL 15 minutes).

Nothing is created by this call. The Telegram contact only comes into existence when the user actually presses Start in Telegram and the resulting /start <token> reaches the instance webhook — pressing Start is both the proof of reachability and the opt-in, which is why this channel has no verification code round-trip.

A replayed token is a no-op, not a second contact. Poll GET /api/v1/orgs/{org}/users/me/notification-routes to observe the new contact appear.

Request​

Responses​

Connect link minted