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

Chat ID. Input routes also accept the local chat ID from this installation when available.

messageID: string

Message ID.

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 send tracking

ReturnsExpand Collapse

chatID: string

Chat ID. Input routes also accept the local chat ID from this installation when available.

messageID: string

Message ID.

reactionKey: string

Reaction key that was added.

success: true

Always true. Indicates the reaction was queued; failures return an error response.

transactionID: string

Transaction ID used for send tracking.

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": "!whatsapp_15550101002:ba_EvYDBBsZbRQAy3UOSWqG0LuTVkc.local-whatsapp.localhost",
  "messageID": "1343993",
  "reactionKey": "❤️",
  "success": true,
  "transactionID": "txn_v3a8f4c9d2e1"
}

Returns Examples

200 example

{
  "chatID": "!whatsapp_15550101002:ba_EvYDBBsZbRQAy3UOSWqG0LuTVkc.local-whatsapp.localhost",
  "messageID": "1343993",
  "reactionKey": "❤️",
  "success": true,
  "transactionID": "txn_v3a8f4c9d2e1"
}