v3

latestOpenAPI 3.1.02026-08-087684214.2 KB

messages

Send Reaction

Send a tapback reaction to a message (iMessage only).

Reactions are available only for iMessage messages. Attempting to react to an SMS message or another channel that does not support tapbacks returns a clear error.

post/v1/messages/{message_id}/reactions

Path parameters

message_idstring required

Request body

reactionstring required

iMessage reaction to send. Classic tapbacks (love, like, dislike, laugh, emphasize, question) are supported on every iMessage line. Custom emoji reactions (e.g. "🔥", "😂", "👍") are supported on newer lines only; lines that don't support them return a 400 with upgrade instructions. Custom emoji also require the recipient to be on macOS 14 / iOS 17 or later.

Example request

{
  "reaction": "love"
}

Response

Successful Response

idstring required

reaction_typestring required

message_idstring required

channelstring required