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.

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

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

This endpoint expects an object.

1	const url = 'https://api.agentphone.ai/v1/messages/message_id/reactions';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"reaction":"love"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

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

1	const url = 'https://api.agentphone.ai/v1/messages/message_id/reactions';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"reaction":"love"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

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