---
title: "Create Telegram Link"
method: POST
path: "/v1/integrations/telegram/link"
tags: ["Integrations"]
---

# Create Telegram Link

`POST /v1/integrations/telegram/link`

## Request

- Base URL: `https://api.fettle.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fettle.sh/v1/integrations/telegram/link`
- Auth: API key in header `Authorization`

Issue a one-time deep-link binding a Telegram chat to the active organization.

## Headers

- `X-Organization-Id` string, uuid, nullable

## Response `201`

Successful Response

- TelegramLinkResponse: Response body for ``POST /v1/integrations/telegram/link``.
  - `deep_link` string, required: Open this URL to bind your Telegram account.
  - `token` string, required: Raw token (also embedded in deep_link).
  - `ttl_seconds` integer, required: Lifetime of the token in seconds.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fettle/apis/fettle-sh.md) · [All operations](https://skmtc.dev/fettle/apis/fettle-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/fettle/apis/fettle-sh/revisions/f32c8a18606f?raw)