Reactionsv2

Add or remove a reaction

POST/chats/{chatId}/messages/{messageId}/reactions

Add or remove a reaction to a message. Supports classic iMessage tapbacks (love, like, dislike, laugh, emphasize, question) and emoji reactions (e.g. +😂, -😂).

The messageId can be an explicit message ID (e.g., msg_xxx) or a relative index (-1 for last message, -2 for second-to-last, etc.). When using relative indices, you can optionally filter by message direction (inbound/outbound only).

Path parameters

chatIdRequiredstring

Chat identifier. Can be: (1) phone number in E.164 format (e.g., +15551234567), (2) email address, (3) group ID (grp_xxxx), or (4) comma-separated list of phone numbers/emails for multi-recipient group chats (e.g., +15551234567,+15559876543). All values should be URL-encoded.

messageIdRequiredstring

Message ID (e.g., msg_xxx) or relative index (-1, -2, etc.)

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON

reactionRequiredstring

The reaction to add or remove. Must be prefixed with + to add or - to remove. **Classic tapbacks:** +love, -love, +like, -like, +dislike, -dislike, +laugh, -laugh, +emphasize, -emphasize, +question, -question **Emoji reactions:** Any emoji prefixed with + or - (e.g. +😂, -😂, +👍, -🔥).

directionoptionalstring

Filter by message direction (only used when messageId is a relative index like -1, -2)

"inbound""outbound"

Returns

successoptionalboolean

Whether the reaction was sent successfully

message_idoptionalstring

The ID of the message that was reacted to

reactionoptionalstring

The reaction that was added or removed. For classic tapbacks: love, like, dislike, laugh, emphasize, question. For emoji reactions: the emoji character (e.g. 😂, 👍, 🔥).

actionoptionalstring

The action that was performed

"add""remove"

Response codes

200Reaction added or removed successfully

400Invalid request parameters

401Authentication required or invalid

404Resource not found

502Temporary communication error

503Device not available

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X POST https://api.blooio.com/v2/api/chats/chat_a1b2c3d4/messages/msg_a1b2c3d4/reactions \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "reaction": "string",    "direction": "inbound"  }'

Body object

{  "reaction": "string",  "direction": "inbound"}

Response objectexample

{  "success": false,  "message_id": "msg_a1b2c3d4",  "reaction": "string",  "action": "add"}