Telegram Upload API Text, Photos & Videos

Post content to Telegram programmatically. Bot token API simplified.

telegram-upload.ts

import { UploadPost } from 'upload-post';

const uploader = new UploadPost('your-api-key');

await uploader.upload('video.mp4', {
  title: 'My Telegram post',
  platforms: ['telegram']
});

Can you post to Telegram via API?

Yes. Upload-Post sends text, photos and videos to Telegram channels and group chats with one REST call (platform[]=telegram). You connect a bot token and chat_id once, then never touch the Telegram Bot API again. It's the easiest way to automate channel announcements alongside your other social posts.

Telegram API Features

Text Posts

Send text messages to Telegram channels and chats.

Photo Posts

Share images directly to your channels.

Video Posts

Upload native videos to Telegram.

Bot Token

Publish using a bot token and chat_id.

Channels & Chats

Post to any channel or chat your bot can reach.

Scheduling

Schedule posts for optimal engagement.

How do you post to Telegram with one request?

One POST to /api/upload. Send a file or a public URL

Request (cURL)

curl -X POST https://api.upload-post.com/api/upload \
  -H 'Authorization: Apikey your-api-key-here' \
  -F 'user=my-profile' \
  -F 'platform[]=telegram' \
  -F 'video=@/path/to/update.mp4' \
  -F 'title=Weekly product update: new features inside'

Response (200 OK)

{
  "success": true,
  "results": {
    "telegram": {
      "success": true,
      "message_sent": true
    }
  },
  "usage": { "count": 5, "limit": 100 }
}

Long uploads switch to background automatically; poll the Upload Status endpoint with your request_id. Full reference in the Upload API docs.

What are the Telegram content requirements and limits?

What the API accepts for Telegram: sizes, formats and platform limits

Requirement	Value
Text messages	Up to 4,096 characters per message (Telegram Bot API limit)
Media captions	Up to 1,024 characters on photos and videos
File uploads	Up to 50 MB per file via the Bot API
Image formats	JPG, PNG
Video formats	MP4 recommended (H.264 + AAC)
Destinations	Channels and group chats your bot is an admin/member of, addressed by chat_id

Telegram Bot API limits verified July 2026: 4,096-char messages, 1,024-char captions, 50 MB uploads. Need to reformat a video first? Use the FFmpeg API.

Start posting to Telegram in minutes

Three steps to integrate the Telegram API

Create your account

Connect Telegram

Link your Telegram destination once from the dashboard. We handle auth and delivery for you.

Upload programmatically

POST to the API with your content and you're live. Schedule or queue posts the same way.

Telegram API FAQ

Common questions about posting to Telegram programmatically

Is there an API to post to a Telegram channel?

Yes. Telegram’s own Bot API works, but it means writing and hosting bot code. Upload-Post wraps it. Connect a bot token and the target chat_id once in the dashboard, then publish with a single POST using platform[]=telegram, the same call that posts to your other networks.

How do I connect my Telegram channel?

Create a bot with @BotFather (takes a minute, and it's free), add it to your channel as an administrator with posting rights, then paste the bot token and channel chat_id into the Upload-Post dashboard. From then on, posting is a plain REST call.

What are Telegram’s size and length limits?

Text messages are capped at 4,096 characters and media captions at 1,024 characters. Bot file uploads are limited to 50 MB per file. If your video is larger, compress or split it with the Upload-Post FFmpeg API before sending.

Can I schedule Telegram posts?

Yes. Add scheduled_date (ISO-8601, optional IANA timezone) to schedule up to 365 days ahead, or add_to_queue to use your preset posting slots. Scheduled posts can be listed, edited and cancelled via the API.

Can one API call post to Telegram and other platforms at once?

Yes, that's the whole point of a unified API. Add several platform[] values (for example telegram, discord and x) to a single request and the same content is adapted and delivered to each network at the same time.

Prefer an AI agent? Use the Telegram MCP server. Plans and limits are in the pricing section.

Ready to automate your Telegram presence?

Start posting to Telegram programmatically today.

Create Free Account