Telegram Bot API adds sendPaidMedia for paid photos and videos in channels
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:
sendPaidMediawithchat_id,star_count,media(an array ofInputPaidMediaPhotoorInputPaidMediaVideo) and an optionalcaption. - Limits today:
star_count1 to 25,000; up to 10 media items; caption 0 to 1,024 characters after entities parsing; optionalpayloadof 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
PaidMediaPurchasedupdates; 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:
copyMessageandcopyMessagescannot be used to copy paid media, so cross-posting a paid post means sending it again. ChatFullInfo.can_send_paid_mediatells 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 withsendPaidMedia, and re-send rather than copy when cross-posting paid media.
Primary sources
- Telegram Bot API changelog: July 1, 2024 (Bot API 7.6)
- Telegram Bot API changelog: August 14, 2024 (Bot API 7.9)
- Telegram Bot API changelog: December 31, 2025 (Bot API 9.3)
- Telegram Bot API: sendPaidMedia
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.