React to an existing message with emoji or tapback | Message Blue

curl -X POST https://api.messageblue.ai/reactToMessage \
     -H "X-App-Id: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "originalMessageGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "reaction": "heart"
}'

{
  "ok": true,
  "data": {
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "status": "sent",
    "type": "result",
    "from": "+14155552671",
    "to": "+14155559876",
    "groupId": "",
    "text": "",
    "attachments": [],
    "messageGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "chatGuid": "chat-1234abcd5678efgh",
    "outbound": true,
    "iMessageNumber": "+14155552671",
    "idempotencyKey": "a1b2c3d4e5f67890"
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-07-10T06:00:00.000Z"
  }
}

Sends an iMessage tapback reaction (e.g. heart, thumbs-up) to a specific message identified by its GUID. Pass remove: true to remove an existing reaction.

Authentication

X-App-Idstring

Your MessageBlue App ID, sent in clear on every request. It is paired with request signing: each request is also signed with your App Secret (see the Authentication tag). The App Secret itself is NEVER transmitted — it is only the HMAC signing key.

Request

This endpoint expects an object.

originalMessageGuidstringRequired

reactionstringRequired

fromstringOptional

tostringOptional

groupIdstringOptional

removebooleanOptional

Response

Reaction sent

okboolean

dataobject

Endpoint-specific payload wrapped in a standard success envelope.

metaobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

503

Service Unavailable Error

504

Gateway Timeout Error

Authentication

Headers

Request

Response

Errors