telegram.org

Telegram is a cloud messaging platform with consumer apps, bots, and developer tools for building custom Telegram clients and business verification flows. It also provides website and app login capabilities tied to Telegram accounts.

3 integrations · REST

Telegram exposes three developer-facing API surfaces on telegram.org: the HTTP Telegram Bot API, the HTTP Telegram Gateway API, and the Telegram API/MTProto platform for custom clients; it also documents Telegram Login/OIDC credentials but not as a standalone API surface here.

discovered 1d ago

REST · OpenAPI3

Telegram Bot APIdiscoveredrest
Telegram Gateway APIdiscoveredrest
Telegram API (MTProto)discoveredrest

Credentials

Telegram bot tokenbearerGet token ↗

Create a bot with @BotFather as described in Bots: An introduction for developers. BotFather issues the bot token used to call the Bot API. Keep the token secret.

Telegram API app credentials (`api_id` + `api_hash`)compoundGet key ↗

Sign in at my.telegram.org, open API development tools, and create an application as described in Creating your Telegram Application. Telegram will show your api_id and api_hash. These are required when authorizing a client against the Telegram API/TDLib.

Telegram Gateway access tokenbearer

Open your Telegram Gateway account settings and create an access token, as required by the Gateway API authorization. The overview page links to the Gateway API and testing guide at Telegram Gateway.

conventions · 0/8 published

integrations.json✗/.well-known/integrations.json
llms.txt✗/llms.txt
API catalog✗/.well-known/api-catalog
OpenAPI document✗/api/schema/, /openapi.json, /swagger.json, /api/openapi.json, or /v1/openapi.json
MCP server card✗/.well-known/mcp/server-card.json
OAuth protected resource✗/.well-known/oauth-protected-resource
Agent card✗/.well-known/agent-card.json
Agent skills✗/.well-known/agent-skills/index.json

Publish these signals → /publishing