> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SMS senden

> Sende eine SMS über deine Famulor-Telefonnummer per API. Triggere transaktionale Texte oder Follow-ups nach KI-Anrufen, Lead-Capture oder Kampagnen.

Dieser Endpunkt ermöglicht es dir, SMS-Nachrichten über deine erworbenen Telefonnummern zu senden. Die SMS wird über Twilio versendet und die Kosten werden automatisch von deinem Kontoguthaben abgezogen.

### Anfrage-Body

<ParamField body="from" type="integer" required>
  Die ID deiner Telefonnummer, von der die SMS gesendet werden soll (muss SMS-fähig sein)
</ParamField>

<ParamField body="to" type="string" required>
  Die Telefonnummer des Empfängers im internationalen Format (z.B. "+4915123456789")
</ParamField>

<ParamField body="body" type="string" required>
  Der SMS-Nachrichteninhalt (max. 300 Zeichen)
</ParamField>

### Antwort-Felder

<ResponseField name="message" type="string">
  Erfolgsmeldung, die bestätigt, dass die SMS gesendet wurde
</ResponseField>

<ResponseField name="data" type="object">
  Zusätzliche Daten zur gesendeten SMS
</ResponseField>

### Fehler-Antworten

<ResponseField name="400 Bad Request" type="object">
  <Expandable title="Fehler-Details">
    <ResponseField name="message" type="string">
      Fehlermeldung, die das Problem beschreibt (ungültige Telefonnummer, unzureichendes Guthaben, etc.)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="500 Internal Server Error" type="object">
  <Expandable title="Server-Fehler">
    <ResponseField name="message" type="string">
      Fehlermeldung, die auf einen SMS-Versandfehler hinweist
    </ResponseField>

    <ResponseField name="error" type="string">
      Detaillierte Fehlerinformationen
    </ResponseField>
  </Expandable>
</ResponseField>

### 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

<ResponseExample>
  ```json 200 Erfolgreich gesendet theme={null}
  {
    "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"
    }
  }
  ```

  ```json 400 Ungültige Anfrage theme={null}
  {
    "message": "Invalid phone number format"
  }
  ```

  ```json 400 Unzureichendes Guthaben theme={null}
  {
    "message": "Insufficient balance to send SMS"
  }
  ```

  ```json 400 Telefonnummer nicht SMS-fähig theme={null}
  {
    "message": "Phone number is not SMS-capable"
  }
  ```

  ```json 400 Telefonnummer nicht gefunden theme={null}
  {
    "message": "From number not found"
  }
  ```

  ```json 500 Server-Fehler theme={null}
  {
    "message": "Failed to send SMS",
    "error": "Twilio service temporarily unavailable"
  }
  ```
</ResponseExample>

<Tip>
  Passende Seiten: [Introduction](/de/api-reference/introduction) und [Authentication Guide](/de/developers/authentication-guide) und [API Integration Examples](/de/developers/api-integration-examples).
</Tip>