Actions101
- Bot Actions
- Chat Actions
- Get Chat
- Get Chat Administrators
- Get Chat Member Count
- Get Chat Member
- Ban Chat Member
- Unban Chat Member
- Restrict Chat Member
- Promote Chat Member
- Set Chat Administrator Custom Title
- Set Chat Permissions
- Export Chat Invite Link
- Create Chat Invite Link
- Edit Chat Invite Link
- Revoke Chat Invite Link
- Approve Chat Join Request
- Decline Chat Join Request
- Set Chat Photo
- Delete Chat Photo
- Set Chat Title
- Set Chat Description
- Pin Chat Message
- Unpin Chat Message
- Unpin All Chat Messages
- Leave Chat
- Set Chat Menu Button
- Get Chat Menu Button
- Set Chat Sticker Set
- Delete Chat Sticker Set
- File Actions
- Forum Actions
- Game Actions
- Inline Actions
- Message Actions
- Send Message
- Forward Message
- Copy Message
- Send Photo
- Send Audio
- Send Document
- Send Video
- Send Animation
- Send Voice
- Send Video Note
- Send Media Group
- Send Location
- Send Venue
- Send Contact
- Send Poll
- Send Dice
- Send Chat Action
- Edit Message Text
- Edit Message Caption
- Edit Message Media
- Edit Message Reply Markup
- Edit Message Live Location
- Stop Message Live Location
- Stop Poll
- Delete Message
- Delete Messages
- Payment Actions
- Sticker Actions
- Update Actions
- Webhook Actions
Chat → Promote Chat Member
AI-generatedSummary
Promote a chat member with optional permission settings
Inputs
- chat_id (required) — Unique identifier for the target chat or username (@channelusername)
- user_id (required) — Unique identifier of the target user
- promoteAdditionalFields — Set additional promotion permissions (e.g., can_manage_chat, can_post_messages) – optional, defaults to none
Output shape
a single JSON object representing the Telegram API response for the promoted member
If the request succeeds, the response's 'result' field is returned; on error the item contains an '_error' field.
Examples
Example 1: Grant admin rights to a user in a group
chat_id = '@mygroup', user_id = 123456789, promoteAdditionalFields = {"can_manage_chat": true, "can_post_messages": true}
Example 2: Give a user permission to manage topics and edit messages
chat_id = '123456789', user_id = 987654321, promoteAdditionalFields = {"can_manage_topics": true, "can_edit_messages": true}
Example 3: Promote with default permissions (no extra fields)
chat_id = 'mygroup', user_id = 11223344