Skip to main content
POST
https://app.famulor.de/api/
/
user
/
sms
Send SMS
curl --request POST \
  --url https://app.famulor.de/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"
  }
}
Send SMS messages to any phone number using your purchased Famulor phone numbers. Messages are delivered via Twilio and charges are automatically deducted from your account.

​
Request Body

​
from
integer
required
Your phone number ID to send from (must support SMS functionality)
​
to
string
required
Recipient’s phone number in international format (example: +1234567890)
​
body
string
required
Message content (maximum 300 characters)

​
Response

​
message
string
Success confirmation message
​
data
object
SMS record details

​
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 sending number must be owned by your account
  • SMS capability must be enabled on the phone number
  • Phone number subscription must be active
  • Your account must have sufficient credits
  • Phone numbers are automatically converted to E.164 format
  • Pricing varies by destination country and is charged per segment
  • Long messages are split into multiple segments, which increases cost
  • Recipient numbers must be valid according to international phone standards