Skip to content

transferGift

Returns boolean

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.

Required: business_connection_id, owned_gift_id, new_owner_chat_id · Optional: 1 parameters

Try it
Token saved
Response

TypeScript example · @effect-ak/tg-bot-client
import { makeTgBotClient } from "@effect-ak/tg-bot-client"
const client = makeTgBotClient({ bot_token: "YOUR_BOT_TOKEN" })
const result = await client.execute("transfer_gift", {
business_connection_id: "...",
owned_gift_id: "...",
new_owner_chat_id: 0
})

Parameters

business_connection_id string Required
Unique identifier of the business connection.

owned_gift_id string Required
Unique identifier of the regular gift that should be transferred.

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

star_count number
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.

transferBusinessAccountStars