Create a forum topic; requires manage_topics rights.
Method schema is available as of layer 148. Switch ยป
| Name | Type | Description |
|---|---|---|
| flags | # | Flags, see TL conditional fields |
| channel | InputChannel | The forum |
| title | string | Topic title (maximum UTF-8 length: 128) |
| icon_color | flags.0?int | If no custom emoji icon is specified, specifies the color of the fallback topic icon (RGB), one of 0x6FB9F0, 0xFFD67E, 0xCB86DB, 0x8EEE98, 0xFF93B2, or 0xFB6F5F. |
| icon_emoji_id | flags.3?long | ID of the custom emoji used as topic icon. Telegram Premium users can use any custom emoji, other users can only use the custom emojis contained in the inputStickerSetEmojiDefaultTopicIcons emoji pack. |
| random_id | long | Unique client message ID to prevent duplicate sending of the same event |
| send_as | flags.2?InputPeer | Create the topic as the specified peer |
| Code | Type | Description |
|---|---|---|
| 400 | CHANNEL_FORUM_MISSING | This supergroup is not a forum. |
| 400 | CHANNEL_INVALID | The provided channel is invalid. |
| 403 | CHAT_WRITE_FORBIDDEN | You can't write in this chat. |
| 403 | PREMIUM_ACCOUNT_REQUIRED | A premium account is required to execute this action. |
| 400 | TOPIC_TITLE_EMPTY | The specified topic title is empty. |
Telegram allows creating forums with multiple distinct topics.
Telegram allows including animated and static custom emojis inside of messages.
Telegram Premium is an optional subscription service that unlocks additional exclusive client-side and API-side features, while helping support the development of the app.
Default custom emoji stickerset for forum topic icons
How to handle admin permissions, granular bans and global permissions in channels, groups and supergroups.