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

# Lead erstellen

> Erstelle einen neuen Lead im Famulor-System per API. Übermittle Kontaktdaten, Custom Variables und triggere KI-Telefonassistenten-Anrufe.

<Warning>
  **Famulor 1.0 API (Legacy).** Diese Seite gilt nur für Famulor 1.0 (`app.famulor.de`) und bleibt aus Kompatibilitätsgründen erhalten. Für die aktuelle Plattform nutze die [Famulor 2.0 API-Referenz](/de/api-reference/introduction).
</Warning>

Mit diesem Endpunkt fügst du einer deiner Kampagnen einen neuen Lead hinzu. Leads sind potenzielle Kunden, die deine Assistenten anrufen.

### Anfrage-Body

<ParamField body="phone_number" type="string" required>
  Telefonnummer des Kontakts im E.164-Format (Beispiel: +1234567890)
</ParamField>

<ParamField body="campaign_id" type="integer" required>
  Die ID der Kampagne, der dieser Lead hinzugefügt werden soll
</ParamField>

<ParamField body="variables" type="object" optional>
  Eigene Datenfelder, die diesem Lead zugeordnet werden

  <Expandable title="Eigenschaften von variables">
    <ParamField body="customer_name" type="string" default="<string>">
      Vollständiger Name des Kunden
    </ParamField>

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

<ParamField body="allow_dupplicate" type="boolean" optional>
  Erlaubt das Anlegen doppelter Leads innerhalb derselben Kampagne (Standard: false)
</ParamField>

<ParamField body="secondary_contacts" type="array" optional>
  Weitere Ansprechpartner, die mit diesem Lead verknüpft sind

  <Expandable title="Eigenschaften von secondary_contacts">
    <ParamField body="phone_number" type="string" required>
      Telefonnummer des zusätzlichen Kontakts im E.164-Format
    </ParamField>

    <ParamField body="variables" type="object" optional>
      Eigene Variablen für den zusätzlichen Kontakt

      <Expandable title="Eigenschaften von variables">
        <ParamField body="customer_name" type="string" default="<string>">
          Name des zusätzlichen Kontakts
        </ParamField>

        <ParamField body="email" type="string" default="<string>">
          E-Mail des zusätzlichen Kontakts
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

### Antwort-Felder

<ResponseField name="message" type="string">
  Bestätigungsmeldung bei Erfolg
</ResponseField>

<ResponseField name="data" type="object">
  Das angelegte Lead-Objekt mit allen zugehörigen Daten

  <Expandable title="Eigenschaften von data">
    <ResponseField name="id" type="integer">
      Eindeutige Kennung des neuen Leads
    </ResponseField>

    <ResponseField name="campaign_id" type="integer">
      Kennung der Kampagne, der dieser Lead zugeordnet ist
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Telefonnummer des Leads im E.164-Format
    </ResponseField>

    <ResponseField name="variables" type="object">
      Eigene Variablen, die zum Lead gespeichert sind

      <Expandable title="Eigenschaften von variables">
        <ResponseField name="customer_name" type="string" default="<string>">
          Name des Kunden
        </ResponseField>

        <ResponseField name="email" type="string" default="<string>">
          E-Mail-Adresse des Kunden
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="status" type="string">
      Aktueller Status des Leads
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Zeitstempel der Erstellung
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Zeitstempel der letzten Änderung
    </ResponseField>

    <ResponseField name="campaign" type="object">
      Kampagnendetails zu diesem Lead

      <Expandable title="Eigenschaften von campaign">
        <ResponseField name="id" type="integer">
          Kennung der Kampagne
        </ResponseField>

        <ResponseField name="name" type="string">
          Name der Kampagne
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="secondary_contacts" type="array">
      Liste der zusätzlichen Kontakte, die mit diesem Lead angelegt wurden

      <Expandable title="Eigenschaften von secondary_contacts">
        <ResponseField name="id" type="integer">
          Kennung des zusätzlichen Kontakts
        </ResponseField>

        <ResponseField name="phone_number" type="string">
          Telefonnummer des zusätzlichen Kontakts im E.164-Format
        </ResponseField>

        <ResponseField name="variables" type="object">
          Variablen des zusätzlichen Kontakts
        </ResponseField>

        <ResponseField name="status" type="string">
          Status des zusätzlichen Kontakts
        </ResponseField>

        <ResponseField name="created_at" type="string">
          Zeitstempel der Erstellung des zusätzlichen Kontakts
        </ResponseField>

        <ResponseField name="updated_at" type="string">
          Zeitstempel der letzten Änderung des zusätzlichen Kontakts
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  {
    "message": "Lead created successfully",
    "data": {
      "id": 1,
      "campaign_id": 1,
      "phone_number": "+1234567890",
      "variables": {
        "customer_name": "John Doe",
        "email": "john.doe@example.com"
      },
      "status": "created",
      "created_at": "2025-06-30 11:53:20",
      "updated_at": "2025-06-30 11:53:20",
      "campaign": {
        "id": 1,
        "name": "My new campaign"
      },
      "secondary_contacts": [
        {
          "id": 2,
          "phone_number": "+1234567891",
          "variables": {
            "customer_name": "Jane Doe Secondary",
            "email": "jane.doe.secondary@example.com"
          },
          "status": "created",
          "created_at": "2025-06-30 11:53:20",
          "updated_at": "2025-06-30 11:53:20"
        },
        {
          "id": 3,
          "phone_number": "+1234567892",
          "variables": {
            "customer_name": "Bob Doe Office",
            "email": "bob.doe.office@example.com"
          },
          "status": "created",
          "created_at": "2025-06-30 11:53:20",
          "updated_at": "2025-06-30 11:53:20"
        }
      ]
    }
  }
  ```
</ResponseExample>

<Tip>
  Verwandte Seiten: [Einführung](/de/api-v1/introduction) und [Authentifizierungs-Leitfaden](/de/api-v1/authentication) sowie [API-Integrationsbeispiele](/de/api-v1/introduction).
</Tip>