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

# Créer une lead list

> POST /lead/

Les lead lists sont la fonctionnalité de capture de leads d'origine de Scanova — une définition de formulaire (`data`) rattachée à la page de destination d'un QR code. Listez-les ou créez-en ici.

<Warning>
  Les Lead Lists sont une fonctionnalité **historique**. Le tableau de bord de Scanova oriente désormais les nouveaux cas d'usage de capture de leads vers les [Formulaires](/fr/api-reference/management-api/forms/create), qui couvrent le même cas d'usage « collecter des données de visiteurs à partir d'un scan de QR code » avec un outil de création plus performant. Les lead lists existantes continuent de fonctionner, et cet endpoint n'est pas affecté, mais construisez vos nouvelles intégrations sur les Formulaires, sauf si vous devez spécifiquement gérer une lead list préexistante.
</Warning>

<Note>
  Nécessite une clé Management API avec le quota `MANAGEMENT_API` (ou `MANAGEMENT_API_SANDBOX`), envoyée comme valeur brute de l'en-tête `Authorization` — voir la [vue d'ensemble de la Management API](/fr/api-reference/management-api/overview).
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://management.scanova.io/lead/' \
    --header 'Authorization: YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
      "name": "Trade Show Signup",
      "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": 205,
    "lead_id": "L9c2f4a1e",
    "name": "Trade Show Signup",
    "created": "2026-08-16T20:44:51.008000+05:30",
    "is_active": true,
    "usage_count": 0,
    "entries_count": 0,
    "linked_qrs": [],
    "modified": "2026-08-16T20:44:51.008000+05:30",
    "data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
    "webhooks": []
  }
  ```
</ResponseExample>

<ParamField body="name" type="string" required>
  Nom de la lead list, jusqu'à 128 caractères.
</ParamField>

<ParamField body="data" type="string" required>
  Une chaîne encodée en JSON (et non un objet brut) décrivant les champs du formulaire de lead. Validée par rapport au même schéma de formulaire de lead que celui utilisé par l'outil de création de lead lists du tableau de bord — un JSON mal formé ou une violation de schéma renvoie une erreur 400 sous `data`.
</ParamField>

<ParamField body="is_active" type="boolean" default="true">
  Indique si le formulaire s'affiche sur la page de destination.
</ParamField>

<Note>
  La réponse inclut `data` et `webhooks` (une liste de webhooks de notification `{id, url, created, modified}`) — des champs présents uniquement dans la structure détaillée renvoyée par la création/récupération, et non dans l'endpoint de liste ci-dessus.
</Note>

## Voir aussi

* [Lister les lead lists](/fr/api-reference/management-api/leads/list) — l'autre opération de ce même endpoint.
* [Gestion des formulaires](/fr/api-reference/management-api/forms/create) — l'outil de capture de leads actuel et recommandé vers lequel cette fonctionnalité historique est orientée.
* [Vue d'ensemble de la Management API](/fr/api-reference/management-api/overview) — le schéma d'authentification et l'architecture de quotas dont fait partie cet endpoint.


## OpenAPI

````yaml api-reference/openapi/management-api.json POST /lead/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    management.scanova.io (QR codes, folders, tags, leads, forms, analytics,
    plans, shared users & roles), plus the token-creation and usage-stats
    endpoints used to authenticate against it. Every path and request/response
    shape below was verified live against a real API key and the actual running
    backend (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://management.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /lead/:
    post:
      summary: Create a lead list
      operationId: createManagedLeadList
      responses:
        '201':
          description: Lead list created
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. management.scanova.io) — the same key sent to
        the regular API host will not authenticate.

````