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

1772129047728

api_version
string
required
Example:

"v2026.2.26"

object
string
required
Example:

"response"

data
object
required