Skip to navigation
API Referencemessages

Send Reaction

React to a message on an eligible iMessage line or WhatsApp connection. Classic tapback names work on supported iMessage lines; custom emoji require a line that supports them. Standard SMS/MMS and branded RCS lines reject this endpoint. The response uses reaction_type and message_id; webhook event fields use camelCase.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

message_idstringRequired

Headers

X-Sub-Account-IdstringOptional

Request

This endpoint expects an object.
reactionstringRequired

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.

Response

Successful Response
idstring
reaction_typestring
message_idstring
channelstring

Errors

422
Unprocessable Entity Error