Telegram Bot API

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. Returns information about the created topic as a ForumTopic object.

post/createForumTopic

Request

  • Base URL: https://api.telegram.org/bot<bot_token>
  • URL: https://api.telegram.org/bot<bot_token>/createForumTopic
  • Auth: none declared

Request body

namestring required

Topic name, 1-128 characters

icon_color7322096 | 16766590 | 13338331 | 9367192 | 16749490 | 16478047

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_idstring

Unique identifier of the custom emoji shown as the topic icon. Use getForumTopicIconStickers to get all allowed custom emoji identifiers.

Response

Telegram API response

oktrue required

Changes

No recorded changes to this operation across all 3 revisions of this API.