create_forum_topic()

Client.create_forum_topic()

Use this method to create a topic in a forum supergroup chat or a private chat with a user.

In the case of a supergroup chat the bot must be an administrator in the chat for this to work and must have the can_manage_topics administrator right.

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:

:obj:`~pyrogram.types.Message` (On success, the sent text message is returned.)

Example

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