API Reference

Chats

Messages

Reactions

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Add a reaction

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

Add a reaction to an existing message.

Path ParametersExpand Collapse

chatID: string

Unique identifier of the chat.

messageID: string

Body ParametersJSONExpand Collapse

reactionKey: string

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

minLength1

transactionID: optional string

Optional transaction ID for deduplication and local echo tracking

ReturnsExpand Collapse

chatID: string

Unique identifier of the chat.

messageID: string

Message ID.

reactionKey: string

Reaction key that was added

success: true

Whether the reaction was successfully added

transactionID: string

Transaction ID used for the reaction event

Add a reaction

HTTP

HTTP

TypeScript

Python

Go

CLI Tool

PHP

curl http://localhost:23373/v1/chats/$CHAT_ID/messages/$MESSAGE_ID/reactions \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $BEEPER_ACCESS_TOKEN" \
    -d '{
          "reactionKey": "x"
        }'

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"
}