POST /sendVideoNote – Photon Telegram Bot API

Telegram Bot API

Changed on Jun 14, 2026

As of v.4.0, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. Use this method to send video messages. On success, the sent Message is returned.

post/sendVideoNote

Request

Base URL: https://api.telegram.org/bot<bot_token>
URL: https://api.telegram.org/bot<bot_token>/sendVideoNote
Auth: none declared

Request body

business_connection_idstring

Unique identifier of the business connection on behalf of which the message will be sent

message_thread_idinteger

Unique identifier for the target message thread (topic) of a forum; for forum supergroups and private chats of bots with forum topic mode enabled only

direct_messages_topic_idinteger

Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat

video_notestring required

Video note to send. Pass a file_id as String to send a video note that exists on the Telegram servers (recommended) or upload a new video using multipart/form-data. More information on Sending Files ». Sending video notes by a URL is currently unsupported.

durationinteger

Duration of sent video in seconds

lengthinteger

Video width and height, i.e. diameter of the video message

thumbnailstring

Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »

disable_notificationboolean

Sends the message silently. Users will receive a notification with no sound.

protect_contentboolean

Protects the contents of the sent message from forwarding and saving

allow_paid_broadcastboolean

Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance.

message_effect_idstring

Unique identifier of the message effect to be added to the message; for private chats only

Response

Telegram API response

oktrue required

Changes

Jun 14, 2026e4c250383b33 Revision changes
- info
  added the new optional request property //////////// (media type: application/json)
- info
  added the new optional request property //////////// (media type: multipart/form-data)
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ///////// to the response with the status

Operation history