Send Reaction | AgentPhone

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.

Authentication

AuthorizationBearer

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

Path parameters

message_idstringRequired

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

1	import { AgentPhoneClient } from "agentphone";
2
3	async function main() {
4	const client = new AgentPhoneClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.messages.sendReaction("message_id", {
8	reaction: "love",
9	});
10	}
11	main();

1	{
2	"id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3	"reaction_type": "love",
4	"message_id": "msg_9876543210",
5	"channel": "iMessage"
6	}