API Reference

Chats

Messages

Reactions

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Add a reaction

chats.messages.reactions.add(strmessage_id, ReactionAddParams**kwargs) -> ReactionAddResponse

POST/v1/chats/{chatID}/messages/{messageID}/reactions

Add a reaction to an existing message.

ParametersExpand Collapse

chat_id: str

Unique identifier of the chat.

message_id: str

reaction_key: str

Reaction key to add (emoji, shortcode, or custom emoji key)

minLength1

transaction_id: Optional[str]

Optional transaction ID for deduplication and local echo tracking

ReturnsExpand Collapse

class ReactionAddResponse: …

chat_id: str

Unique identifier of the chat.

message_id: str

Message ID.

reaction_key: str

Reaction key that was added

success: Literal[true]

Whether the reaction was successfully added

transaction_id: str

Transaction ID used for the reaction event

Add a reaction

Python

HTTP

TypeScript

Python

Go

CLI Tool

PHP

import os
from beeper_desktop_api import BeeperDesktop

client = BeeperDesktop(
    access_token=os.environ.get("BEEPER_ACCESS_TOKEN"),  # This is the default and can be omitted
)
response = client.chats.messages.reactions.add(
    message_id="messageID",
    chat_id="!NCdzlIaMjZUmvmvyHU:beeper.com",
    reaction_key="x",
)
print(response.chat_id)

200 example

{
  "chatID": "!signal_adamvy:local-signal.localhost",
  "messageID": "1343993",
  "reactionKey": "❤️",
  "success": true,
  "transactionID": "txn_123"
}

Returns Examples

200 example

{
  "chatID": "!signal_adamvy:local-signal.localhost",
  "messageID": "1343993",
  "reactionKey": "❤️",
  "success": true,
  "transactionID": "txn_123"
}