Skip to main content

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 with user (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 → the StickerSet (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):

FieldDescription
owner_user_idNumeric Telegram user id of the owner.
nameShort name ending in _by_<bot_username>, 1-64 characters.
title1-64 characters.
stickers1-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_typeregular (default), mask or custom_emoji.
needs_repaintingCustom emoji sets only.

The response carries url (https://t.me/addstickers/<name>).

Edit​

PATCH /api/uploadposts/telegram/sticker-sets with action:

actionFieldsTelegram method
add_stickerowner_user_id, name, sticker (InputSticker)addStickerToSet
replace_stickerowner_user_id, name, old_sticker (file_id), stickerreplaceStickerInSet
delete_stickersticker (file_id), confirm: truedeleteStickerFromSet
set_positionsticker, position (zero-based)setStickerPositionInSet
set_emoji_liststicker, emoji_list (1-20)setStickerEmojiList
set_keywordssticker, keywords (0-20)setStickerKeywords
set_mask_positionsticker, mask_position (omit to remove)setStickerMaskPosition
set_titlename, titlesetStickerSetTitle
set_thumbnailname, owner_user_id, format, thumbnail (file, thumbnail_url or file_id; omit to drop)setStickerSetThumbnail
set_custom_emoji_thumbnailname, 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.