---
title: "Start Telegram Link"
method: POST
path: "/v1/me/external-identities/telegram/link"
tags: ["v1", "protected", "external-identities"]
---

# Start Telegram Link

`POST /v1/me/external-identities/telegram/link`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

A deep link that offers the caller's account to whoever opens it in Telegram.

## Request body

- TelegramLinkRequest
  - `bot` string, required: The bot to open the link in

## Response `200`

Successful Response

- TelegramLinkResponse
  - `expires_in` integer, required
  - `url` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-10** `6270c1b4d938`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentarea/apis/agentarea-api/changes/v1/me/external-identities/telegram/link/post.md)

---

[API](https://skmtc.dev/agentarea/apis/agentarea-api.md) - [All operations](https://skmtc.dev/agentarea/apis/agentarea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentarea/apis/agentarea-api/revisions/5b651833a114?raw)