messages.createForumTopic

Create a forum topic.

 Method schema is available as of layer 216. Switch »

Parameters

Name Type Description
flags # Flags, see TL conditional fields
title_missing flags.4?true  
peer InputPeer The supergroup, private chat (for forum-enabled bots) or forum bot (for users) where to create the topic.
title string Topic title (maximum UTF-8 length: 128)
icon_color flags.0?int If no custom emoji icon is specified, specifies the color of the fallback topic icon (RGB), one of 0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F.
icon_emoji_id flags.3?long ID of the custom emoji used as topic icon. Telegram Premium users can use any custom emoji, other users can only use the custom emojis contained in the inputStickerSetEmojiDefaultTopicIcons emoji pack.
random_id long Unique client message ID to prevent duplicate sending of the same event
send_as flags.2?InputPeer Create the topic as the specified peer

Result

Updates

Both users and bots can use this method

Possible errors

Code Type Description
400 CHANNEL_FORUM_MISSING This supergroup is not a forum.
400 CHANNEL_INVALID The provided channel is invalid.
400 PEER_ID_INVALID The provided peer id is invalid.

Related pages

Custom emojis

Telegram allows including animated and static custom emojis inside of messages.

Telegram Premium

Telegram Premium is an optional subscription service that unlocks additional exclusive client-side and API-side features, while helping support the development of the app.

inputStickerSetEmojiDefaultTopicIcons

Default custom emoji stickerset for forum topic icons

Forums

Telegram allows creating forums with multiple distinct topics.