> ## 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/calls/make",
  "feedback": "Description of the issue"
}
```

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

</AgentInstructions>

# Anruf tätigen

> Einen Anruf mit einem bestimmten Assistenten tätigen

Dieser Endpunkt ermöglicht es Ihnen, einen Anruf zu tätigen.

### Request Body

<ParamField body="phone_number" type="string" required>
  Die Telefonnummer des Kunden im E.164-Format (z.B. +1234567890)
</ParamField>

<ParamField body="assistant_id" type="integer" required>
  Die ID des Assistenten, mit dem der Anruf getätigt werden soll
</ParamField>

<ParamField body="variables" type="object">
  Die Variablen, die an den Lead übergeben werden sollen

  <Expandable title="Variable-Eigenschaften">
    <ParamField body="customer_name" type="string" default="<string>">
      Der Name des Kunden
    </ParamField>

    <ParamField body="email" type="string" default="<string>">
      Die E-Mail-Adresse des Kunden
    </ParamField>
  </Expandable>
</ParamField>

### Response

<ResponseField name="message" type="string">
  Bestätigungsnachricht, dass der Anruf erfolgreich initiiert wurde
</ResponseField>

<ResponseField name="call_id" type="integer">
  Die eindeutige ID des erstellten Anrufs
</ResponseField>

<ResponseField name="status" type="string">
  Der initiale Status des Anrufs (z.B. "initiated")
</ResponseField>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://app.famulor.de/api/user/make_call" \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "phone_number": "+4915123456789",
      "assistant_id": 123,
      "variables": {
        "customer_name": "Max Mustermann",
        "email": "max.mustermann@example.com"
      }
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://app.famulor.de/api/user/make_call", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: "Bearer YOUR_API_TOKEN",
    },
    body: JSON.stringify({
      phone_number: "+4915123456789",
      assistant_id: 123,
      variables: {
        customer_name: "Max Mustermann",
        email: "max.mustermann@example.com",
      },
    }),
  });

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

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

  payload = {
      "phone_number": "+4915123456789",
      "assistant_id": 123,
      "variables": {
          "customer_name": "Max Mustermann",
          "email": "max.mustermann@example.com",
      },
  }

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

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

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "message": "Call initiated successfully",
    "call_id": 480337,
    "status": "initiated"
  }
  ```

  ```json 400 Ungültige Telefonnummer theme={null}
  {
    "message": "Invalid phone number format. Please use E.164 format (e.g. +1234567890)"
  }
  ```

  ```json 404 Assistent nicht gefunden theme={null}
  {
    "message": "Assistant not found or does not belong to the authenticated user"
  }
  ```

  ```json 422 Unzureichendes Guthaben theme={null}
  {
    "message": "Insufficient balance to make call. Please top up your account."
  }
  ```
</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>