React to a message
POST /v1/messages/reaction — add or remove an emoji reaction.
Notes
message_idis the message you are reacting to. For a message you sent, that is thedata.message_idyou got back from the send.- Set
from_me: truewhen reacting to a message you sent from this number. It defaults tofalse, meaning a message the contact sent you, and it cannot be worked out from the id alone — which is why it is a separate field. emojimust be a single emoji with no spaces, up to 24 characters (a multi-part emoji such as 👨👩👧 counts as several).- Send
"emoji": ""to remove a reaction you added earlier. That is WhatsApp’s own behaviour, not a validation gap. - This is the only send type that does not accept
quoted_message_id— the message key already identifies the conversation.
Add a reaction
Remove it again
Authorizations
Your API key, sent in an apikey request header. Never in the URL, never as a Bearer token.
Body
Which of your connected numbers to send FROM. Copy it from your numbers screen in the portal, or from GET /v1/instances. It must belong to your account.
"3f9c1a2b-7d4e-4c81-9f0a-2b6d5e8c1a34"
The recipient, with country code and no leading zero — for example 919876543210. Spaces, dashes, brackets and a leading + are accepted and stripped; 6 to 15 digits must remain.
"919876543210"
The message to react to — the data.message_id returned when it was sent. Letters, digits, _, =, +, / and - only.
128"3EB0C1D2F4A5B6C7D8E9"
A single emoji with no spaces. Send an empty string to REMOVE a reaction you added earlier — that is WhatsApp's own behaviour, not an error.
24"👍"
Set true when reacting to a message you sent from this number. Defaults to false (a message the contact sent you).

