Skip to main content
POST
/
text
/
reactions
cURL
curl --request POST \
  --url https://api.contiguity.com/send/text/reactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reaction": "love",
  "action": "add"
}
'
{
  "id": "req_xxxxxxxxxxxxxxxx",
  "timestamp": 1770840693983,
  "api_version": "v2026.2.11",
  "object": "response",
  "data": {
    "message_id": "text_xyz7fsdlkv89"
  }
}
Sending an SMS and adding a reaction.
Reactions are billed as a single SMS on the Usage tier, included in the Unlimited plan, and deducted from your quota on the Free tier.

There are no additional charges. Both adding and removing reactions count toward your quota.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
reaction
enum<string>
required

Reaction type.

Available options:
love,
thumbsup,
thumbsdown,
haha,
emphasized,
questioned
Example:

"love"

​
action
enum<string>
required

Add or remove the reaction.

Available options:
add,
remove
Example:

"add"

​
message_id
string | null

Option A: ID of the message to react to (e.g. text_xxx). Contiguity auto-fills the required fields.

Example:

"text_abc123"

​
to
string | null

Option B: Recipient phone (E.164). Required when not using message_id.

Example:

"+1234567890"

​
from
string | null

Option B: Your number to send from (E.164). Optional if you provide a message_id.

Example:

"+15555555555"

​
message
string | null

Option B: Exact content of the message you are reacting to. Required when not using message_id.

Example:

"Hello there!"

Response

Send a reaction to a message via SMS! Use either message_id to react to a message, or provide message information manually.

​
id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

​
timestamp
number
required
Example:

1770840693983

​
api_version
string
required
Example:

"v2026.2.11"

​
object
string
required
Example:

"response"

​
data
object
required