Skip to main content
Contiguity expects the recipient phone number to be formatted in E.164. The SDK does not convert formats.

Send SMS/MMS

const res = await contiguity.text.send({
  to: "+1234567890",
  message: "Hello from Contiguity!",
  // from: "+15555555555",
  // attachments: ["https://example.com/image.png"]  // optional, max 3
});

Fetch a message

const res = await contiguity.text.get("msg_...");

Conversation history

const res = await contiguity.text.history({
  to: "+1234567890",
  from: "+15555555555",
  limit: 20   // optional, default 20
});

Reactions

// Add or remove a tapback
const res = await contiguity.text.react("add", {
  reaction: "love",   // "love" | "thumbsup" | "thumbsdown" | "haha" | "emphasized" | "questioned"
  message_id: "msg_..."
});
// Or reference by to + from + message
await contiguity.text.react("remove", { reaction: "thumbsup", to: "+1234567890", from: "+15555555555", message: "Hello" });

Parameters

text.send(params)

to
string
required
Recipient phone number in E.164 format.
message
string
required
The text message content.
from
string
Optional sender number (e.g. a leased number).
attachments
string[]
Optional array of attachment URLs (max 3) for MMS.
fast_track
boolean
Optional. Bypass recommended rate limiting on leased numbers. Requires Fast Track entitlement.

text.get(id)

id
string
required
Message ID returned from send or webhooks.

text.history(params)

to
string
required
Recipient phone number (E.164).
from
string
required
Sender phone number (E.164).
limit
number
default:"20"
Max number of messages to return.

text.react(action, params)

action
string
required
"add" or "remove".
reaction
string
required
One of: "love", "thumbsup", "thumbsdown", "haha", "emphasized", "questioned".
message_id
string
Message ID, or use to + from + message to reference the message.

Response (send / get / history / react)

message_id
string
Unique identifier for the message (send/react).
metadata
object
Request metadata: id, timestamp, api_version, object.