Skip to main content
POST
cURL
Contiguity supports iCloud emails… but their behavior is unpredictable at times.

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. E.164 phone number or email (e.g. name@icloud.com).

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!"

allow_from_me
boolean | null

If true, allow reacting to a message sent by from (your own outbound iMessage). Defaults to false.

Example:

false

Response

Add or remove a reaction to an iMessage

id
string
required
Example:

"req_xxxxxxxxxxxxxxxx"

timestamp
number
required
Example:

1787117739720

api_version
string
required
Example:

"v2026.8.19"

object
string
required
Example:

"response"

data
object
required