# Telegram Bot API API

> Telegram Bot API API on Apizie: 74 endpoints (Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields…, Use this method to send answers to callback queries sent from [inline…, Use this method to send answers to an inline query. On success, *True* is returned. No more than **50**…, Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmation in…, …) returned as clean JSON through one API key. 74 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/communication:telegram/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:telegram`
- Category: Communication
- Status: live
- Source: https://telegram.org
- Page: https://zieapi.vercel.app/api/communication/telegram
- OpenAPI: https://zieapi.vercel.app/api/communication/telegram/openapi.json

Auto-generated OpenAPI schema

## Endpoints

### Use this method to add a new sticker to a set created by the bot. You **must** use exactly one of the fields…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-add-sticker-to-set`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to send answers to callback queries sent from [inline…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-answer-callback-query`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send answers to an inline query. On success, *True* is returned. No more than **50**…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-answer-inline-query`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmation in…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-answer-pre-checkout-query`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### If you sent an invoice requesting a shipping address and the parameter *is\_flexible* was specified, the Bot…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-answer-shipping-query`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to close the bot instance before moving it from one local server to another. You need to…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-close`

### Use this method to copy messages of any kind. The method is analogous to the method…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-copy-message`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker set…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-create-new-sticker-set`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to delete a chat photo. Photos can't be changed for private chats. The bot must be an…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-delete-chat-photo`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in the…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-delete-chat-sticker-set`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to delete a message, including service messages, with the following limitations: \- A…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-delete-message`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to delete a sticker from a set created by the bot. Returns *True* on success.
`POST https://zieapi.vercel.app/v1/communication:telegram/post-delete-sticker-from-set`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to remove webhook integration if you decide to switch back to…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-delete-webhook`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to edit captions of messages. On success, if the edited message is not an inline message,…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-edit-message-caption`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to edit live location messages. A location can be edited until its *live\_period* expires or…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-edit-message-live-location`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to edit animation, audio, document, photo, or video messages. If a message is part of a…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-edit-message-media`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to edit only the reply markup of messages. On success, if the edited message is not an…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-edit-message-reply-markup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to edit text and [game](https://core.telegram.org/bots/api/#games) messages. On success, if…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-edit-message-text`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to generate a new invite link for a chat; any previously generated link is revoked. The bot…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-export-chat-invite-link`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to forward messages of any kind. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-forward-message`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to get up to date information about the chat (current name of the user for one-on-one…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-chat`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to get a list of administrators in a chat. On success, returns an Array of…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-chat-administrators`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to get information about a member of a chat. Returns a…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-chat-member`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to get the number of members in a chat. Returns *Int* on success.
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-chat-members-count`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to get basic info about a file and prepare it for downloading. For the moment, bots can…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-file`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to get data for high score tables. Will return the score of the specified user and several…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-game-high-scores`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### A simple method for testing your bot's auth token. Requires no parameters. Returns basic information about…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-me`

### Use this method to get the current list of the bot's commands. Requires no parameters. Returns Array of…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-my-commands`

### Use this method to get a sticker set. On success, a…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-sticker-set`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to receive incoming updates using long polling…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-updates`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to get a list of profile pictures for a user. Returns a…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-user-profile-photos`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to get current webhook status. Requires no parameters. On success, returns a…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-get-webhook-info`

### Use this method to kick a user from a group, a supergroup or a channel. In the case of supergroups and…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-kick-chat-member`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method for your bot to leave a group, supergroup or channel. Returns *True* on success.
`POST https://zieapi.vercel.app/v1/communication:telegram/post-leave-chat`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to log out from the cloud Bot API server before launching the bot locally. You **must** log…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-log-out`

### Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-pin-chat-message`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-promote-chat-member`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergroup for…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-restrict-chat-member`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-animation`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to send audio files, if you want Telegram clients to display them in the music player. Your…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-audio`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method when you need to tell the user that something is happening on the bot's side. The status is…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-chat-action`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send phone contacts. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-contact`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send an animated emoji that will display a random value. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-dice`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send general files. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-document`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to send a game. On success, the sent [Message](https://core.telegram.org/bots/api/#message)…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-game`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send invoices. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-invoice`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send point on the map. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-location`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-media-group`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to send text messages. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-message`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send photos. On success, the sent [Message](https://core.telegram.org/bots/api/#message)…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-photo`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to send a native poll. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-poll`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send static .WEBP or [animated](https://telegram.org/blog/animated-stickers) .TGS…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-sticker`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to send information about a venue. On success, the sent…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-venue`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to send video files, Telegram clients support mp4 videos (other formats may be sent as…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-video`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### As of [v.4.0](https://telegram.org/blog/video-messages-and-telescope), Telegram clients support rounded…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-video-note`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to send audio files, if you want Telegram clients to display the file as a playable voice…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-send-voice`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to set a custom title for an administrator in a supergroup promoted by the bot. Returns…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-chat-administrator-custom-title`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to change the description of a group, a supergroup or a channel. The bot must be an…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-chat-description`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to set default chat permissions for all members. The bot must be an administrator in the…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-chat-permissions`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to set a new profile photo for the chat. Photos can't be changed for private chats. The bot…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-chat-photo`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to set a new group sticker set for a supergroup. The bot must be an administrator in the…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-chat-sticker-set`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to change the title of a chat. Titles can't be changed for private chats. The bot must be an…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-chat-title`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to set the score of the specified user in a game. On success, if the message was sent by the…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-game-score`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to change the list of the bot's commands. Returns *True* on success.
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-my-commands`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Informs a user that some of the Telegram Passport elements they provided contains errors. The user will not…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-passport-data-errors`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to move a sticker in a set created by the bot to a specific position. Returns *True* on…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-sticker-position-in-set`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to set the thumbnail of a sticker set. Animated thumbnails can be set for animated sticker…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-sticker-set-thumb`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to specify a url and receive incoming updates via an outgoing webhook. Whenever there is an…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-set-webhook`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

### Use this method to stop updating a live location message before *live\_period* expires. On success, if the…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-stop-message-live-location`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to stop a poll which was sent by the bot. On success, the stopped…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-stop-poll`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to unban a previously kicked user in a supergroup or channel. The user will **not** return…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-unban-chat-member`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to clear the list of pinned messages in a chat. If the chat is not a private chat, the bot…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-unpin-all-chat-messages`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a private…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-unpin-chat-message`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Use this method to upload a .PNG file with a sticker for later use in *createNewStickerSet* and…
`POST https://zieapi.vercel.app/v1/communication:telegram/post-upload-sticker-file`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | Form fields as a JSON object |

## Example
```
curl "https://zieapi.vercel.app/v1/communication:telegram/post-add-sticker-to-set" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Telegram Bot API API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/communication:telegram/post-add-sticker-to-set with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Telegram Bot API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Telegram Bot API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:telegram.

### What is the status of the Telegram Bot API API?
Live: works with just an Apizie key