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

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.famulor.io/feedback

```json
{
  "path": "/de/api-reference/sms/send",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# SMS senden

> Eine SMS-Nachricht über Ihre Telefonnummer senden

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

<ParamField body="from" type="integer" required>
  Die ID Ihrer 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

<CodeGroup>
  ```bash cURL theme={null}
  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": "Hallo! Dies ist eine Test-SMS von Famulor."
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://app.famulor.de/api/user/sms", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: "Bearer YOUR_API_KEY",
    },
    body: JSON.stringify({
      from: 12345,
      to: "+4915123456789",
      body: "Hallo! Dies ist eine Test-SMS von Famulor.",
    }),
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  payload = {
      "from": 12345,
      "to": "+4915123456789",
      "body": "Hallo! Dies ist eine Test-SMS von Famulor.",
  }

  response = requests.post(
      "https://app.famulor.de/api/user/sms",
      headers={
          "Content-Type": "application/json",
          "Authorization": "Bearer YOUR_API_KEY",
      },
      json=payload,
      timeout=10,
  )

  print(response.json())
  ```
</CodeGroup>

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