Telegram Ads API reference
Hosted connections, Telegram Ads reads and MCP. Use an extension session for owned connections or a scoped AI grant for MCP. Examples use placeholders; run requests from your own client. Campaign mutations are not exposed by this hosted API.
Authentication
- HTTP: Bearer Auth
- API Key: serviceKey
- HTTP: Bearer Auth
- HTTP: Bearer Auth
- HTTP: Bearer Auth
Revocable extension session from PKCE exchange
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Internal server-to-server only; never expose to browsers
Security Scheme Type: | apiKey |
|---|---|
Header parameter name: | X-Telemetrio-Service-Key |
Single-purpose credential from ads_prepare_file_upload; authorizes only one exact binary PUT
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Exact selected connection grant, internal MCP issuer only
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Operator-provisioned personal token; not OAuth
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |