Send Reaction
Messages
Send Reaction
Send an iMessage tapback reaction to an existing message in your workspace. REST endpoint in the Tuco AI iMessage API — bearer-token auth, JSON.
POST
Send Reaction
Use this endpoint to react to an existing message with a native iMessage tapback.
The target message must already exist in Tuco and belong to your workspace.
What This Endpoint Does
This endpoint adds a native iMessage reaction to an existing message in a conversation. It is useful when you want your integration to behave more like a human operator in Unibox, for example:- acknowledging a message with a quick tapback
- reacting before sending a longer reply
- mirroring a lightweight action a user took in your own system
Authentication
Pass your workspace API key as a Bearer token, or use a Clerk session token.Request body
The Tuco message ID to react to. Required.
Required reaction type.Supported values:
"love""like""dislike""laugh""emphasize""question"
Example
Response
Success (200 OK)
Error responses
Notes
- Reactions are workspace-scoped: you can only react to messages inside your own workspace.
- Sending the same reaction again toggles it off.
- Tuco keeps only one outbound self-reaction per message at a time, matching native iMessage behavior.
- If you also want to receive inbound reactions from leads, see Message Webhooks.