---
title: "Send Reaction"
method: POST
path: "/v1/messages/{message_id}/reactions"
tags: ["messages"]
---

# Send Reaction

`POST /v1/messages/{message_id}/reactions`

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.

## Path parameters

- `message_id` string, required

## Request body

- SendReactionRequest
  - `reaction` string, 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.

## Response `200`

Successful Response

- SendReactionResponse
  - `id` string, required
  - `reaction_type` string, required
  - `message_id` string, required
  - `channel` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/agentphone/apis/agentphone-api.md) · [All operations](https://skmtc.net/agentphone/apis/agentphone-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agentphone/agentphone-api/versions/5724ccaa33d8/schema)