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 → Unban Chat Member
AI-generatedSummary
Unban a previously banned member from a specified chat, optionally only if the user is currently banned.
Inputs
- Chat ID (required) — Unique identifier for the target chat or username (@channelusername).
- User ID (required) — Unique identifier of the target user to unban.
- Only If Banned — If set to true, the operation will do nothing if the user is not banned.
Output shape
a single object containing the result of the unban operation from Telegram, typically a boolean indicating success.
The operation returns the Telegram API response's 'result' field or an error. It does not paginate.
Examples
Example 1: Unban a banned user from a group chat unconditionally
Specify the Chat ID and User ID to unban the user from the chat.
Example 2: Unban a user only if they are currently banned
Specify the Chat ID, User ID, and set 'Only If Banned' to true to prevent errors if the user is not banned.