Skip to main content
POST
/
user
/
sms
Send SMS
curl --request POST \
  --url https://app.clickspeak.ai/api/user/sms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": 123,
  "to": "<string>",
  "body": "<string>"
}
'
{
  "message": "SMS sent successfully",
  "data": {
    "id": 456,
    "phone_number_id": 78,
    "to": "+1234567890",
    "body": "Hello! This is a test message from Your Company. How can we help you today?",
    "user_id": 1,
    "segments": 1,
    "segment_price": 0.0075,
    "total_cost": 0.0075,
    "status": "sent",
    "sms_sid": "SM1234567890abcdef1234567890abcdef",
    "created_at": "2025-08-04 15:30:00",
    "updated_at": "2025-08-04 15:30:02"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.clickspeak.ai/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint allows you to send SMS messages using your purchased phone numbers. The SMS will be sent via Twilio and costs will be automatically deducted from your account balance.

​
Request Body

​
from
integer
required
The ID of your phone number to send the SMS from (must be SMS-capable)
​
to
string
required
The recipient’s phone number in international format (e.g., “+1234567890”)
​
body
string
required
The SMS message content (max 300 characters)

​
Response

​
message
string
Success message confirming SMS was sent
​
data
object

​
Error Responses

​
400 Bad Request
​
500 Internal Server Error
{
  "message": "SMS sent successfully",
  "data": {
    "id": 456,
    "phone_number_id": 78,
    "to": "+1234567890",
    "body": "Hello! This is a test message from Your Company. How can we help you today?",
    "user_id": 1,
    "segments": 1,
    "segment_price": 0.0075,
    "total_cost": 0.0075,
    "status": "sent",
    "sms_sid": "SM1234567890abcdef1234567890abcdef",
    "created_at": "2025-08-04 15:30:00",
    "updated_at": "2025-08-04 15:30:02"
  }
}

​
Notes

  • The sender phone number must belong to the authenticated user
  • The sender phone number must be SMS-capable
  • The phone number subscription must be active (not expired)
  • Sufficient account balance is required to cover SMS costs
  • Phone numbers are automatically formatted to E.164 format
  • SMS costs vary by destination country and are charged per segment
  • Long messages may be split into multiple segments, increasing the cost
  • The recipient phone number must be valid according to international standards