create_forum_topic()#

Client.create_forum_topic()#

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.

Usable by ✅ Users ✅ Bots
Parameters:

  • chat_id (int | str) – Unique identifier (int) or username (str) of the target chat. For your personal cloud (Saved Messages) you can simply use “me” or “self”. For a contact that exists in your Telegram address book you can use his phone number (str).

  • name (str) – Topic name, 1-128 characters

  • icon_color (int, optional) – 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, optional) – Unique identifier of the custom emoji shown as the topic icon. Use get_forum_topic_icon_stickers() to get all allowed custom emoji identifiers.

  • send_as (int | str, optional) – Unique identifier (int) or username (str) of the as chat. For your personal cloud (Saved Messages) you can simply use “me”. Use get_send_as_chats() to get allowed values.

Returns:

Message – On success, the sent text message is returned.

Example

# Create a new Topic
await app.create_forum_topic(chat, "Topic Title")