channels.createForumTopic

Create a forum topic; requires manage_topics rights.

updatesTooLong#e317af7e = Updates;
updateShortMessage#313bc7f8 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int user_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShortChatMessage#4d6deea5 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true id:int from_id:long chat_id:long message:string pts:int pts_count:int date:int fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long reply_to:flags.3?MessageReplyHeader entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
updateShort#78d4dec1 update:Update date:int = Updates;
updatesCombined#725b04c3 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq_start:int seq:int = Updates;
updates#74ae4240 updates:Vector<Update> users:Vector<User> chats:Vector<Chat> date:int seq:int = Updates;
updateShortSentMessage#9015e101 flags:# out:flags.1?true id:int pts:int pts_count:int date:int media:flags.9?MessageMedia entities:flags.7?Vector<MessageEntity> ttl_period:flags.25?int = Updates;
---functions---
channels.createForumTopic#f40c0224 flags:# channel:InputChannel title:string icon_color:flags.0?int icon_emoji_id:flags.3?long random_id:long send_as:flags.2?InputPeer = Updates;

Parameters

Name Type Description
flags # Flags, see TL conditional fields
channel InputChannel The forum
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

Possible errors

Code Type Description
400 CHANNEL_FORUM_MISSING This supergroup is not a forum.
400 CHANNEL_INVALID The provided channel is invalid.
403 CHAT_WRITE_FORBIDDEN You can't write in this chat.
403 PREMIUM_ACCOUNT_REQUIRED A premium account is required to execute this action.
400 TOPIC_TITLE_EMPTY The specified topic title is empty.

Bots can use this method

Related pages

Forums

Telegram allows creating forums with multiple distinct topics.

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

Admin, banned, default rights

How to handle admin permissions, granular bans and global permissions in channels, groups and supergroups.