MadelineProtoDocs/docs/API_docs/methods/photos.uploadContactProfilePhoto.md

title	description	grand_parent	parent	image	redirect_from
photos.uploadContactProfilePhoto	Upload a custom profile picture for a contact, or suggest a new profile picture to a contact.	Telegram RPC API	Methods	https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png	/API_docs/methods/photos_uploadContactProfilePhoto.html

Method: photos.uploadContactProfilePhoto

Back to methods index

Upload a custom profile picture for a contact, or suggest a new profile picture to a contact.

The file, video and video_emoji_markup flags are mutually exclusive.

Parameters:

Name	Type	Description	Required
suggest	Bool	If set, will send a messageActionSuggestProfilePhoto service message to user_id, suggesting them to use the specified profile picture; otherwise, will set a personal profile picture for the user (only visible to the current user).	Optional
save	Bool	If set, removes a previously set personal profile picture (does not affect suggested profile pictures, to remove them simply deleted the messageActionSuggestProfilePhoto service message with messages.deleteMessages).	Optional
user_id	Username, chat ID, Update, Message or InputUser	The contact	Optional
file	File path or InputFile	Profile photo	Optional
video	File path or InputFile	Animated profile picture video	Optional
video_start_ts	double	Floating point UNIX timestamp in seconds, indicating the frame of the video/sticker that should be used as static preview; can only be used if video or video_emoji_markup is set.	Optional
video_emoji_markup	VideoSize	Animated sticker profile picture, must contain either a videoSizeEmojiMarkup or a videoSizeStickerMarkup constructor.	Optional

Return type: photos.Photo

Can bots use this method: YES

MadelineProto Example (now async for huge speed and parallelism!):

if (!file_exists('madeline.php')) {
    copy('https://phar.madelineproto.xyz/madeline.php', 'madeline.php');
}
include 'madeline.php';

$MadelineProto = new \danog\MadelineProto\API('session.madeline');
$MadelineProto->start();

$photos_Photo = $MadelineProto->photos->uploadContactProfilePhoto(suggest: $Bool, save: $Bool, user_id: $InputUser, file: $InputFile, video: $InputFile, video_start_ts: $double, video_emoji_markup: $VideoSize, );