Skip to main content
POST
/
text
cURL
curl --request POST \
  --url https://api.contiguity.com/send/text \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "to": "+1234567890",
  "message": "Hello, world!"
}'
{
  "id": "req_xxxxxxxxxxxxxxxx",
  "timestamp": 1757916599341,
  "api_version": "v2025.9.15",
  "object": "response",
  "data": {
    "message_id": "text_1234567890"
  }
}
MMS is in public beta. We’re still understanding the limits of our implementation – if you encounter any issues, join our Discord!Note: MMS is limited to 5MB (cumulative), across 3 attachments.
Contiguity will fully support jpeg/jpg, png, and gif. We will accept & attempt to send a number of other content types, however depending on the carrier and device of the end user these messages may not be successfully received.
Confirmed file types that work:
  • Images (JPEG, JPG, PNG, GIF)
  • Videos (MP4, MOV)
  • Audio (MP3)
  • Documents (PDF)
File types that experience issues:
  • WEBP
  • Some images?
  • SVGs
This endpoint is the same as Send a Text. To send attachments, pass them in the attachments parameter.

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 phone number. Must be in E.164 format

Example:

"+1234567890"

​
message
string
required

The text message to send

Example:

"Hello, world!"

​
from
string

If you lease a phone number from Contiguity, you can use a specific one by providing it here.

Example:

"+15555555555"

​
attachments
string[]

Attachments to send. Must be HTTPS-secured URLs with file extensions. Max 3 attachments, 5MB cumulative size.

Maximum length: 3
Example:
["https://example.com/image.png"]

Response

Send a text message

​
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