Returns: ForumTopic

class aiogram.methods.create_forum_topic.CreateForumTopic(*, chat_id: int | str, name: str, icon_color: int | None = None, icon_custom_emoji_id: str | None = None, **extra_data: Any)[source]#

Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator rights. Returns information about the created topic as a aiogram.types.forum_topic.ForumTopic object.


chat_id: int | str#

Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)

name: str#

Topic name, 1-128 characters

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}#

A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

model_post_init(_ModelMetaclass__context: Any) None#

We need to both initialize private attributes and call the user-defined model_post_init method.

icon_color: int | None#

Color of the topic icon in RGB format. Currently, must be one of 7322096 (0x6FB9F0), 16766590 (0xFFD67E), 13338331 (0xCB86DB), 9367192 (0x8EEE98), 16749490 (0xFF93B2), or 16478047 (0xFB6F5F)

icon_custom_emoji_id: str | None#

Unique identifier of the custom emoji shown as the topic icon. Use aiogram.methods.get_forum_topic_icon_stickers.GetForumTopicIconStickers to get all allowed custom emoji identifiers.


As bot method#

result: ForumTopic = await bot.create_forum_topic(...)

Method as object#


  • from aiogram.methods.create_forum_topic import CreateForumTopic

  • alias: from aiogram.methods import CreateForumTopic

With specific bot#

result: ForumTopic = await bot(CreateForumTopic(...))

As reply into Webhook in handler#

return CreateForumTopic(...)