Telegram Bot API

Transfers an owned unique gift to another user. Requires the can_transfer_and_upgrade_gifts business bot right. Requires can_transfer_stars business bot right if the transfer is paid. Returns True on success.

post/transferGift

Request

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

Request body

business_connection_idstring required

Unique identifier of the business connection

owned_gift_idstring required

Unique identifier of the regular gift that should be transferred

new_owner_chat_idinteger required

Unique identifier of the chat which will own the gift. The chat must be active in the last 24 hours.

star_countinteger

The amount of Telegram Stars that will be paid for the transfer from the business account balance. If positive, then the can_transfer_stars business bot right is required.

Response

Telegram API response

oktrue required
resulttrue required

Changes

No recorded changes to this operation across all 3 revisions of this API.