Zum Hauptinhalt springen
POST
/
api
/
user
/
sms
SMS senden
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": "Hallo! Dies ist eine Test-SMS von Famulor.",
    "segments": 1,
    "cost": 0.05,
    "currency": "EUR",
    "status": "sent"
  }
}
Dieser Endpunkt ermöglicht es Ihnen, SMS-Nachrichten über Ihre erworbenen Telefonnummern zu senden. Die SMS wird über Twilio versendet und die Kosten werden automatisch von Ihrem Kontoguthaben abgezogen.

​
Anfrage-Body

​
from
integer
erforderlich
Die ID Ihrer Telefonnummer, von der die SMS gesendet werden soll (muss SMS-fähig sein)
​
to
string
erforderlich
Die Telefonnummer des Empfängers im internationalen Format (z.B. “+4915123456789”)
​
body
string
erforderlich
Der SMS-Nachrichteninhalt (max. 300 Zeichen)

​
Antwort-Felder

​
message
string
Erfolgsmeldung, die bestätigt, dass die SMS gesendet wurde
​
data
object
Zusätzliche Daten zur gesendeten SMS

​
Fehler-Antworten

​
400 Bad Request
object
​
500 Internal Server Error
object

​
Hinweise

  • Die Absender-Telefonnummer muss dem authentifizierten Benutzer gehören
  • Die Absender-Telefonnummer muss SMS-fähig sein
  • Das Telefonnummer-Abonnement muss aktiv sein (nicht abgelaufen)
  • Ausreichendes Kontoguthaben ist erforderlich, um die SMS-Kosten zu decken
  • Telefonnummern werden automatisch in das E.164-Format formatiert
  • SMS-Kosten variieren je nach Zielland und werden pro Segment berechnet
  • Lange Nachrichten können in mehrere Segmente aufgeteilt werden, was die Kosten erhöht
  • Die Empfänger-Telefonnummer muss den internationalen Standards entsprechen
{
  "message": "SMS sent successfully",
  "data": {
    "sms_id": "SMS_67890",
    "from": "+4912345678",
    "to": "+4915123456789",
    "body": "Hallo! Dies ist eine Test-SMS von Famulor.",
    "segments": 1,
    "cost": 0.05,
    "currency": "EUR",
    "status": "sent"
  }
}
Passende Seiten: Introduction und Authentication Guide und API Integration Examples.