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

# Créer un lead

> Ajoute un nouveau lead à votre campagne d'appels sortants Famulor via l'API. Envoie les informations de contact, des variables personnalisées et déclenche des appels de l'agent vocal IA.

<Warning>
  **API Famulor 1.0 (héritée).** Cette page concerne uniquement Famulor 1.0 (`app.famulor.de`) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la [référence API Famulor 2.0](/fr/api-reference/introduction).
</Warning>

Utilisez ce point de terminaison pour ajouter un nouveau lead à l'une de vos campagnes. Les leads représentent des clients potentiels que vos assistants vont appeler.

### Corps de la requête

<ParamField body="phone_number" type="string" required>
  Numéro de téléphone du contact au format E.164 (exemple : +1234567890)
</ParamField>

<ParamField body="campaign_id" type="integer" required>
  L'identifiant de la campagne à laquelle ce lead doit être ajouté
</ParamField>

<ParamField body="variables" type="object" optional>
  Champs de données personnalisés à associer à ce lead

  <Expandable title="Propriétés de variables">
    <ParamField body="customer_name" type="string" default="<string>">
      Nom complet du client
    </ParamField>

    <ParamField body="email" type="string" default="<string>">
      Adresse e-mail du client
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="allow_dupplicate" type="boolean" optional>
  Autoriser la création de leads en double au sein de la même campagne (par défaut : false)
</ParamField>

<ParamField body="secondary_contacts" type="array" optional>
  Personnes de contact supplémentaires liées à ce lead

  <Expandable title="Propriétés de secondary_contacts">
    <ParamField body="phone_number" type="string" required>
      Numéro de téléphone du contact secondaire au format E.164
    </ParamField>

    <ParamField body="variables" type="object" optional>
      Variables personnalisées pour le contact secondaire

      <Expandable title="Propriétés de variables">
        <ParamField body="customer_name" type="string" default="<string>">
          Nom du contact secondaire
        </ParamField>

        <ParamField body="email" type="string" default="<string>">
          E-mail du contact secondaire
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

### Réponse

<ResponseField name="message" type="string">
  Message de confirmation de succès
</ResponseField>

<ResponseField name="data" type="object">
  L'objet lead créé avec toutes les données associées

  <Expandable title="Propriétés de data">
    <ResponseField name="id" type="integer">
      Identifiant unique du nouveau lead
    </ResponseField>

    <ResponseField name="campaign_id" type="integer">
      Identifiant de la campagne à laquelle ce lead est attribué
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      Numéro de contact du lead au format E.164
    </ResponseField>

    <ResponseField name="variables" type="object">
      Variables personnalisées stockées avec le lead

      <Expandable title="Propriétés de variables">
        <ResponseField name="customer_name" type="string" default="<string>">
          Nom du client
        </ResponseField>

        <ResponseField name="email" type="string" default="<string>">
          Adresse e-mail du client
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="status" type="string">
      Statut actuel du lead
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Horodatage de création
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Horodatage de dernière modification
    </ResponseField>

    <ResponseField name="campaign" type="object">
      Détails de la campagne pour ce lead

      <Expandable title="Propriétés de campaign">
        <ResponseField name="id" type="integer">
          Identifiant de la campagne
        </ResponseField>

        <ResponseField name="name" type="string">
          Nom de la campagne
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="secondary_contacts" type="array">
      Liste des contacts secondaires créés avec ce lead

      <Expandable title="Propriétés de secondary_contacts">
        <ResponseField name="id" type="integer">
          Identifiant du contact secondaire
        </ResponseField>

        <ResponseField name="phone_number" type="string">
          Numéro de téléphone du contact secondaire au format E.164
        </ResponseField>

        <ResponseField name="variables" type="object">
          Variables du contact secondaire
        </ResponseField>

        <ResponseField name="status" type="string">
          Statut du contact secondaire
        </ResponseField>

        <ResponseField name="created_at" type="string">
          Horodatage de création du contact secondaire
        </ResponseField>

        <ResponseField name="updated_at" type="string">
          Horodatage de dernière mise à jour du contact secondaire
        </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>
  Pages associées : [Introduction](/fr/api-v1/introduction) et [Guide d'authentification](/fr/api-v1/authentication), et [Exemples d'intégration API](/fr/api-v1/introduction).
</Tip>