Skip to main content
POST
/
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": {
    "sms_id": "SMS_67890",
    "from": "+4912345678",
    "to": "+4915123456789",
    "body": "Hello! This is a test SMS from Famulor.",
    "segments": 1,
    "cost": 0.05,
    "currency": "EUR",
    "status": "sent"
  }
}
This endpoint allows you to send SMS messages via your purchased phone numbers. The SMS is sent through Twilio, and the costs are automatically deducted from your account balance.

​
Request Body

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

​
Response Fields

​
message
string
Success message confirming that the SMS was sent
​
data
object
Additional data about the sent SMS

​
Error Responses

​
400 Bad Request
object
​
500 Internal Server Error
object

​
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 depending on the destination country and are charged per segment
  • Long messages can be split into multiple segments, increasing the cost
  • The recipient phone number must comply with international standards
curl -X POST "https://app.famulor.de/api/user/sms" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": 12345,
    "to": "+4915123456789",
    "body": "Hello! This is a test SMS from Famulor."
  }'

{
  "message": "SMS sent successfully",
  "data": {
    "sms_id": "SMS_67890",
    "from": "+4912345678",
    "to": "+4915123456789",
    "body": "Hello! This is a test SMS from Famulor.",
    "segments": 1,
    "cost": 0.05,
    "currency": "EUR",
    "status": "sent"
  }
}