Telegram Sticker Sets
Create and edit sticker sets with the bot you connected. A set belongs to a Telegram user
(owner_user_id: your own numeric Telegram user id) and only the bot that created it can edit it.
- Authentication: API Key —
Authorization: Apikey <YOUR_API_KEY> - Endpoint:
/api/uploadposts/telegram/sticker-sets, every request withuser(profile username). - Set names must end in
_by_<your_bot_username>(Telegram rule) and use only English letters, digits and underscores. File requirements: https://core.telegram.org/stickers
Read
GET ?user=my-profile&name=pack_by_mybot→ theStickerSet(getStickerSet).GET ?user=my-profile&custom_emoji_ids=id1,id2→ up to 200 custom emoji stickers (getCustomEmojiStickers).
Upload a sticker file
POST /api/uploadposts/telegram/sticker-sets/upload (multipart): owner_user_id, sticker_format
(static .WEBP/.PNG, animated .TGS, video .WEBM) and the file in sticker (or a public
sticker_url). Returns file_id to reuse in the calls below (uploadStickerFile).
Create a set
POST /api/uploadposts/telegram/sticker-sets (JSON or multipart):
| Field | Description |
|---|---|
owner_user_id | Numeric Telegram user id of the owner. |
name | Short name ending in _by_<bot_username>, 1-64 characters. |
title | 1-64 characters. |
stickers | 1-50 InputSticker: sticker (file_id, public URL or attach://<field> pointing at a file of the same multipart request), format, emoji_list (1-20), optional keywords (0-20, 64 characters in total) and mask_position. |
sticker_type | regular (default), mask or custom_emoji. |
needs_repainting | Custom emoji sets only. |
The response carries url (https://t.me/addstickers/<name>).
Edit
PATCH /api/uploadposts/telegram/sticker-sets with action:
action | Fields | Telegram method |
|---|---|---|
add_sticker | owner_user_id, name, sticker (InputSticker) | addStickerToSet |
replace_sticker | owner_user_id, name, old_sticker (file_id), sticker | replaceStickerInSet |
delete_sticker | sticker (file_id), confirm: true | deleteStickerFromSet |
set_position | sticker, position (zero-based) | setStickerPositionInSet |
set_emoji_list | sticker, emoji_list (1-20) | setStickerEmojiList |
set_keywords | sticker, keywords (0-20) | setStickerKeywords |
set_mask_position | sticker, mask_position (omit to remove) | setStickerMaskPosition |
set_title | name, title | setStickerSetTitle |
set_thumbnail | name, owner_user_id, format, thumbnail (file, thumbnail_url or file_id; omit to drop) | setStickerSetThumbnail |
set_custom_emoji_thumbnail | name, custom_emoji_id ("" = use the first sticker) | setCustomEmojiStickerSetThumbnail |
Delete a set
DELETE /api/uploadposts/telegram/sticker-sets with name and confirm: true (deleteStickerSet).
To use a sticker set as the group sticker set of your supergroup, see
chat management (sticker_set_name). Errors follow the
chat management table.