Telegram API Reference

Send messages, media, and stories to Telegram channels and groups via bot.

Quick reference

auth	Bot Token
text Limit	4,096 (text) / 1,024 (caption)
max Media	10 items (media group)
media Rule	Separate limits for text messages and media captions
max Video Duration	N/A
entity Selection	None (register channels via API)
first Comment	Not supported (no comment-creation API)

Content types

✓Text

Up to 4,096 characters for text messages

✓Images

JPEG and PNG only. Max 10 MB.

✓Video

MP4 only. Max 50 MB.

✓GIF

Animated GIFs supported

✓Media group

Up to 10 items. Caption limited to 1,024 chars.

Media requirements

Constraints enforced by Telegram's API. Requests that violate these limits will be rejected.

Constraint	Value
Max image size	`10 MB`
Max video size	`50 MB`
Image formats	`JPEG, PNG`
Video formats	`MP4`
Max media items	`10`
GIF support	`Yes`

Platform settings

Pass these fields inside platformSettings.telegram in the request body.

Name	Type	Required	Description
`disableNotification`	`boolean`	Optional	Send the message silently (no notification sound for recipients).Default: `false`
`parseMode`	`string`	Optional	Enable Markdown formatting in the message. `md`

disableNotification

booleanOptional

Send the message silently (no notification sound for recipients).

Default: false

parseMode

stringOptional

Enable Markdown formatting in the message.

md

Code examples

Basic post

curl -X POST https://schedulala.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Hello from the Schedulala API!",
    "platforms": [
      { "platform": "telegram", "accountId": "acc_tg" }
    ],
    "publishNow": true
  }'

Post with media

curl -X POST https://schedulala.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Check out this photo!",
    "platforms": [
      { "platform": "telegram", "accountId": "acc_tg" }
    ],
    "mediaItems": [
      { "type": "image", "url": "https://example.com/photo.jpg" }
    ],
    "platformSettings": {
      "telegram": {
        "disableNotification": true
      }
    },
    "publishNow": true
  }'

Quirks & gotchas

Connected via Bot Token — create a bot with @BotFather, then add it to your channel/group.

Separate character limits: 4,096 for text messages, 1,024 for media captions.

Only JPEG and PNG images — WebP is not supported.

Only MP4 video format.

Image max: 10 MB. Video max: 50 MB.

Register channels with POST /api/v1/connect/telegram/channels. Posts go to the channel named by platformSettings.telegram.channelId, or the first registered channel if you don't name one.

Posts API — Create and schedule posts across all platforms Media API — Platform-specific media constraints and upload limits Connecting Accounts — OAuth, App Password, and Bot Token flows All Platforms — Compatibility matrix and overview of all 12 platforms