Message Actions

Emoji reactions, starred/favorite messages, and pinned messages

📄️ Pin message

Pins a message to a thread. Only one message can be pinned per thread at a time — pinning a new message automatically unpins the previous one. Requires the `can_pin_messages` permission (controlled by the `better_messages_can_pin_messages` filter). The message must exist and belong to the specified thread.

📄️ Unpin message

Removes the pinned message from a thread. Requires the `can_pin_messages` permission. After unpinning, no message will be pinned in the thread until a new one is explicitly pinned.

📄️ Toggle reaction

Adds or removes an emoji reaction on a message. If the user has already reacted with the same emoji, it is removed (toggle behavior). Users cannot react to their own messages. The emoji must be in the configured reactions list. Returns the updated message with all current reactions.

📄️ Toggle favorite

Stars or unstars a message for the current user. Starred messages can be retrieved later via the getFavorited endpoint. The `disableFavoriteMessages` setting must not be enabled. The operation is idempotent — starring an already-starred message still returns success.

📄️ Get favorited messages

Returns all messages starred by the current user across all conversations. Only returns messages the user still has access to. The `disableFavoriteMessages` setting must not be enabled.