Skip to main content
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

messageId
string
The Tuco message ID to react to. Required.
reaction
string
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.