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

# Crear una lista de leads

> POST /lead/

Las listas de leads son la función original de captura de leads de Scanova — una definición de formulario (`data`) adjunta a la página de destino de un código QR. Listarlas o crearlas aquí.

<Warning>
  Las listas de leads son una función **heredada**. El panel de Scanova ahora orienta los nuevos casos de uso de captura de leads hacia [Formularios](/es/api-reference/management-api/forms/create) en su lugar, que cubren el mismo caso de uso de "recopilar datos del visitante desde un escaneo de QR" con un generador más completo. Las listas de leads existentes siguen funcionando, y este endpoint no se ve afectado, pero construye nuevas integraciones sobre Formularios a menos que necesites específicamente gestionar una lista de leads ya existente.
</Warning>

<Note>
  Requiere una clave de la API de gestión con cuota `MANAGEMENT_API` (o `MANAGEMENT_API_SANDBOX`), enviada como el valor sin procesar del encabezado `Authorization` — consulta el [resumen de la API de gestión](/es/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>
  Nombre de la lista de leads, hasta 128 caracteres.
</ParamField>

<ParamField body="data" type="string" required>
  Una cadena codificada en JSON (no un objeto sin procesar) que describe los campos del formulario de leads. Se valida contra el mismo esquema de formulario de leads que usa el generador de listas de leads del panel — un JSON malformado o una infracción del esquema devuelve un 400 bajo `data`.
</ParamField>

<ParamField body="is_active" type="boolean" default="true">
  Si el formulario se renderiza en la página de destino.
</ParamField>

<Note>
  La respuesta incluye `data` y `webhooks` (una lista de webhooks de notificación `{id, url, created, modified}`) — campos presentes solo en la forma de detalle devuelta por crear/obtener, no en el endpoint de lista.
</Note>

## Relacionado

* [Listar listas de leads](/es/api-reference/management-api/leads/list) — la otra operación de este mismo endpoint.
* [Gestión de formularios](/es/api-reference/management-api/forms/create) — el generador de captura de leads actual y recomendado hacia el que se orienta esta función heredada.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y la arquitectura de cuotas de la que forma parte este 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.

````