Skip to main content
POST
/
imessage
/
reactions
cURL
curl --request POST \
  --url https://api.contiguity.com/send/imessage/reactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "to": "+1234567890",
  "from": "+15555555555",
  "action": "add",
  "tapback": "love",
  "message": "Hello there!"
}'
{
  "id": "req_xxxxxxxxxxxxxxxx",
  "timestamp": 1757916599341,
  "api_version": "v2025.9.15",
  "object": "response",
  "data": {
    "status": "added",
    "message": "Reaction added to +1234567890 from +15555555555"
  }
}
Technically, iCloud emails are supported… but their behavior is unpredictable.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
to
string
required

Recipient's iMessage address. Must be in E.164 format.

Example:

"+1234567890"

​
from
string
required

Your leased iMessage number that has been used to send messages to the recipient. Must be in E.164 format.

Example:

"+15555555555"

​
action
enum<string>
required

Whether to add or remove a reaction

Available options:
add,
remove
Example:

"add"

​
tapback
enum<string>
required

The type of tapback reaction

Available options:
love,
like,
dislike,
laugh,
emphasize,
question
Example:

"love"

​
message
string
required

The full content of the message to react to – Contiguity will find the latest message that matches.

Example:

"Hello there!"

Response

Add or remove a reaction to an iMessage

​
id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

​
timestamp
number
required
Example:

1757916599341

​
api_version
string
required
Example:

"v2025.9.15"

​
object
string
required
Example:

"response"

​
data
object
required
⌘I