Skip to main content
Send an emoji reaction to a message. You can react to both messages you’ve sent and messages you’ve received.
To remove a reaction, send an empty string for the emoji parameter.

Request

message_id
string
required
The unique identifier of the message to react to
X-Device-Id
string
Device identifier for multi-device support. Required when multiple devices are registered. If only one device is registered, it will be used as the default.
phone
string
required
Phone number with country code and WhatsApp suffixExample: [email protected]
emoji
string
required
The emoji to react with. Use any standard emoji character.Example: 🙏

Response

code
string
Response code (e.g., SUCCESS)
message
string
Response message describing the result
results
object
message_id
string
The ID of the original message
status
string
Status of the reaction operation
curl -X POST \
  'https://your-api-domain.com/message/3EB0B430B6F8F1D0E053AC120E0A9E5C/reaction' \
  -H 'Content-Type: application/json' \
  -H 'X-Device-Id: my-device' \
  -u 'username:password' \
  -d '{
    "phone": "[email protected]",
    "emoji": "🙏"
  }'
{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
    "status": "Reaction sent successfully"
  }
}

Build docs developers (and LLMs) love