Skip to content
Schedule Social Media

Press Esc to close.

New feature Telegram Severity: low

Telegram Bot API adds sendPaidMedia for paid photos and videos in channels

Announced1 Jul 2024
Effective1 Jul 2024
StatusIn effect

What changed

Bot API 7.6 (July 1, 2024) added sendPaidMedia and the InputPaidMedia classes for sending paid photos and videos, and documented that copyMessage and copyMessages cannot copy paid media. Bot API 7.9 (August 14, 2024) allowed paid media in any chat. The maximum price was raised to 10,000 Stars in Bot API 9.0 (April 11, 2025) and to 25,000 Stars in Bot API 9.3 (December 31, 2025). Today's API reference allows 1 to 25,000 Stars, up to 10 items and a caption of up to 1,024 characters.

What it means

Bots can post photos and videos that readers unlock by paying Telegram Stars, and channel earnings go to the channel's balance.

Who is affected

Creators who sell content in Telegram channels, and tools that post on their behalf.

What to do by 1 Jul 2024

Optional. Use sendPaidMedia with star_count and up to 10 media items. Note that copyMessage and copyMessages cannot copy paid media.

What this means for you

A channel can now post a photo or video that is blurred until a reader pays a few Telegram Stars, Telegram's in-app coins. Tools can post these for you. If the post goes to a channel, the money goes to the channel. This only matters if you sell content on Telegram.

The details

  • Method: sendPaidMedia with chat_id, star_count, media (an array of InputPaidMediaPhoto or InputPaidMediaVideo) and an optional caption.
  • Limits today: star_count 1 to 25,000; up to 10 media items; caption 0 to 1,024 characters after entities parsing; optional payload of 0 to 128 bytes.
  • Proceeds: "If the chat is a channel, all Telegram Star proceeds from this media will be credited to the chat's balance. Otherwise, they will be credited to the bot's balance."
  • History: Bot API 7.6 launched it; 7.9 allowed paid media "to any chat" and on behalf of business accounts; 7.10 added PaidMediaPurchased updates; 9.0 raised the maximum price to 10,000 Stars; 9.3 raised it to 25,000 Stars; 10.0 added live photos as paid media.
  • Copying: copyMessage and copyMessages cannot be used to copy paid media, so cross-posting a paid post means sending it again.
  • ChatFullInfo.can_send_paid_media tells you whether a chat allows it.

What to do next

  • Business owners: Nothing, unless you sell photos or videos on Telegram.
  • Marketers and agencies: If a client sells content in a Telegram channel, ask whether your scheduler supports paid posts.
  • Developers: Check can_send_paid_media, send with sendPaidMedia, and re-send rather than copy when cross-posting paid media.

Primary sources

Checked against the source 7 Nov 2026

Get an email when a new API change is added

Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.