Skip to content
Telegram Bot SDK Telegram Bot SDK

createForumTopic

Returns ForumTopic ↗

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.

Required: chat_id, name · Optional: 2 parameters

Limits:

  • name: 1-128 characters
Try it
Token saved
Response 













TypeScript example · @effect-ak/tg-bot-client

import { makeTgBotClient } from "@effect-ak/tg-bot-client"


const client = makeTgBotClient({ bot_token: "YOUR_BOT_TOKEN" })


const result = await client.execute("create_forum_topic", {
  chat_id: "YOUR_CHAT_ID",
  name: "..."
})




Parameters


chat_id number | string Required

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


name string Required

Topic name, 1-128 characters.


icon_color number

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 string

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



createChatInviteLink · createChatSubscriptionInviteLink · createInvoiceLink · createNewStickerSet