transferGift

Raw MD
Transfers an owned unique gift to another user
2 min read Botlify Cloud Updated October 2026

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.

Parameters

ParameterTypeRequiredDescription
business_connection_idStringYesUnique identifier of the business connection
owned_gift_idStringYesUnique identifier of the regular gift that should be transferred
new_owner_chat_idIntegerYesUnique identifier of the chat which will own the gift. The chat must be active in the last 24 hours.
star_countIntegerOptionalThe 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.

Example

PHP — Call transferGift on Botlify Cloud
<?php
// ── Botlify Cloud .env — auto-injected, never hardcode secrets ──
$BOT_TOKEN     = getenv('BOT_TOKEN');     // Telegram bot token from @BotFather
$ADMIN_CHAT_ID = getenv('ADMIN_CHAT_ID'); // Your numeric admin Telegram user ID
$BOT_USERNAME  = getenv('BOT_USERNAME');  // Bot username without @

$resp = bot('transferGift', [
    'business_connection_id' => $userId,
    'owned_gift_id' => 'value',
    'new_owner_chat_id' => $chatId,
]);

if ($resp['ok'] ?? false) {
    $result = $resp['result']; // handle the response
}
Botlify Cloud Runtime
Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.