Returns: bool

class aiogram.methods.pin_chat_message.PinChatMessage(*, chat_id: int | str, message_id: int, disable_notification: bool | None = None, **extra_data: Any)[source]#

Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the ‘can_pin_messages’ administrator right in a supergroup or ‘can_edit_messages’ administrator right in a channel. Returns True on success.


chat_id: int | str#

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

message_id: int#

Identifier of a message to pin

model_computed_fields: ClassVar[dict[str, ComputedFieldInfo]] = {}#

A dictionary of computed field names and their corresponding ComputedFieldInfo objects.

model_post_init(_ModelMetaclass__context: Any) None#

We need to both initialize private attributes and call the user-defined model_post_init method.

disable_notification: bool | None#

Pass True if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats.


As bot method#

result: bool = await bot.pin_chat_message(...)

Method as object#


  • from aiogram.methods.pin_chat_message import PinChatMessage

  • alias: from aiogram.methods import PinChatMessage

With specific bot#

result: bool = await bot(PinChatMessage(...))

As reply into Webhook in handler#

return PinChatMessage(...)

As shortcut from received object#