<metaproperty="description"content="Telegram Premium users can grant their favorite channels additional features like the ability to post stories by giving them boosts.">
<metaproperty="og:title"content="Channel boosts">
<metaproperty="og:image"content="">
<metaproperty="og:description"content="Telegram Premium users can grant their favorite channels additional features like the ability to post stories by giving them boosts.">
<p><ahref="/api/premium">Telegram Premium</a> users can grant their favorite channels additional features like the ability to post <ahref="/api/stories">stories</a> by giving them <strong>boosts</strong>. </p>
<p>Channels level up as they gain more boosts – and for each level, they gain additional features. </p>
<p>Additionally, channel admins may gain even more boosts by starting <ahref="/api/giveaways">giveaways »</a>. </p>
<p>The maximum possible boost level for a channel is specified in the <ahref="/api/config#boosts-channel-level-max">boosts_channel_level_max</a> config key.</p>
<p>Each user has a certain number of boost slots that can be assigned to channels: the precise number depends on whether they bought or were gifted a <ahref="/api/premium">Premium</a> subscription, and can be fetched using <ahref="/method/premium.getMyBoosts">premium.getMyBoosts</a>, along with info about the channels currently occupying each slot, if any. </p>
<p><ahref="/api/premium#gifting-telegram-premium">Gifting a Telegram Premium</a> subscription to another user will create <ahref="/api/config#boosts-per-sent-gift">boosts_per_sent_gift</a> new boost slots for us, and one boost slot for the destination user. </p>
<p>Use <ahref="/method/premium.applyBoost">premium.applyBoost</a> to assign some of your boost slots to a channel. </p>
<p>A <code>PREMIUM_ACCOUNT_REQUIRED</code> error will be returned if the current account does not have a <ahref="/api/premium">Telegram Premium</a> subscription.<br>
A <code>BOOST_NOT_MODIFIED</code> RPC error will be returned when calling any of the two methods if the user is already boosting the specified channel with the same slots. </p>
<p>After assigning a slot a channel, the user may not change the boosted channel for that slot for a certain cooldown period, specified in the <ahref="/constructor/myBoost">myBoost</a>.<code>cooldown_until_date</code> field: if the cooldown period isn't over yet, the method will return a 420 <code>FLOOD_WAIT_X</code> error, indicating the number of seconds left before a different channel can be boosted. </p>
<p>Users may also invoke <ahref="/method/premium.getBoostsStatus">premium.getBoostsStatus</a>, to get the current boost status of a channel as a <ahref="/constructor/premium.boostsStatus">premium.boostsStatus</a> constructor, check out the <ahref="/constructor/premium.boostsStatus">constructor page</a> for more info.</p>
<p>Channel administrators may invoke <ahref="/method/premium.getBoostsList">premium.getBoostsList</a> to fetch the list of users currently boosting the channel, and <ahref="/method/premium.getUserBoosts">premium.getUserBoosts</a> to get info about the boosts sent to a channel by a specific user.</p>
<h4><aclass="anchor"href="#posting-stories-as-a-channel"id="posting-stories-as-a-channel"name="posting-stories-as-a-channel"><iclass="anchor-icon"></i></a>Posting stories as a channel</h4>
<p>With each boost, channels can post 1 additional story per day to their subscribers' story feeds.</p>
<p>Everything works exactly the same as when <ahref="/api/stories#posting-stories">posting stories as a user</a>, with the only difference that clients should pass the appropriate <ahref="/constructor/inputPeerChannel">inputPeerChannel</a> instead of <ahref="/constructor/inputPeerSelf">inputPeerSelf</a> to <ahref="/method/stories.canSendStory">stories.canSendStory</a>, <ahref="/method/stories.sendStory">stories.sendStory</a> and all the other story methods, see the <ahref="/api/stories#posting-stories">main documentation »</a> for more info. </p>
<p>Use <ahref="/method/stories.getChatsToSend">stories.getChatsToSend</a> to obtain a list of channels where the user can post stories; <ahref="/method/stories.canSendStory">stories.canSendStory</a> must still be used before uploading a story to make sure no other limit was reached, as described in the <ahref="/api/stories#posting-stories">main documentation »</a>.</p>
<p>After reaching at least the boost level specified in the <code>channel_min_level</code> field of the <ahref="/constructor/help.peerColorOption">help.peerColorOption</a> constructor for the chosen palette, channels gain the ability to change their <ahref="/api/colors">message accent palette »</a>. </p>
<p>After reaching at least the boost level specified in the <ahref="/api/config#channel-bg-icon-level-min"><code>channel_bg_icon_level_min</code> config parameter</a>, channels gain the ability to change the emoji used in the <ahref="/api/colors">message accent palette »</a>. </p>
<p>After reaching at least the boost level specified in the <ahref="/api/config#channel-bg-icon-level-min"><code>channel_profile_bg_icon_level_min</code> config parameter</a> and the boost level specified in the <code>channel_min_level</code> field of the <ahref="/constructor/help.peerColorOption">help.peerColorOption</a> constructor for the chosen palette, channels gain the ability to change the emoji and color used in the <ahref="/api/colors">profile accent palette »</a>. </p>
<p>After reaching at least the boost level specified in the <ahref="/api/config#channel-wallpaper-level-min"><code>channel_wallpaper_level_min</code> config parameter</a>, channels gain the ability to set a <ahref="/api/wallpapers#channel-wallpapers">fill channel wallpaper, see here » for more info</a>.<br>
After reaching at least the boost level specified in the <ahref="/api/config#channel-custom-wallpaper-level-min"><code>channel_custom_wallpaper_level_min</code> config parameter</a>, channels gain the ability to set any custom <ahref="/api/wallpapers">wallpaper</a>, not just <ahref="/api/wallpapers">fill channel wallpapers, see here » for more info</a>. </p>
<h4><aclass="anchor"href="#setting-a-custom-emoji-status"id="setting-a-custom-emoji-status"name="setting-a-custom-emoji-status"><iclass="anchor-icon"></i></a>Setting a custom emoji status</h4>
<p>After reaching at least the boost level specified in the <ahref="/api/config#channel-emoji-status-level-min"><code>channel_emoji_status_level_min</code> config parameter</a>, channels gain the ability to change their <ahref="/api/emoji-status">status emoji »</a>.</p></div>
</div>
</div>
</div>
<divclass="footer_wrap">
<divclass="footer_columns_wrap footer_desktop">
<divclass="footer_column footer_column_telegram">
<h5>Telegram</h5>
<divclass="footer_telegram_description"></div>
Telegram is a cloud-based mobile and desktop messaging app with a focus on security and speed.
