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

# Convertir una lista de leads en un Formulario

> POST /lead/{lead_id}/convert/

Migra una lista de leads heredada a un [Formulario](/es/api-reference/management-api/forms/create) — el generador de captura de leads actual y recomendado de Scanova.

<Note>
  Requiere una clave de API de gestión con cuota `MANAGEMENT_API` (o `MANAGEMENT_API_SANDBOX`), enviada como el valor sin procesar del encabezado `Authorization` — consulte el [resumen de la API de gestión](/es/api-reference/management-api/overview).
</Note>

<ParamField path="lead_id" type="string" required>
  El `lead_id` de la lista de leads. Sin cuerpo de solicitud.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://api.scanova.io/lead/L9c2f4a1e/convert/' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": 512,
    "form_id": "F3b9c1a2",
    "lead_id": "L9c2f4a1e"
  }
  ```
</ResponseExample>

Al convertir una lista de leads:

* Se crea un nuevo Formulario a partir de las definiciones de campo de la lista de leads.
* Cada código QR actualmente adjunto a la lista de leads se vuelve a vincular al nuevo Formulario.
* Los webhooks activos se migran al mecanismo de webhooks del Formulario (los propios webhooks de la lista de leads se marcan como inactivos).
* Cualquier notificación de leads configurada para esta lista de leads se migra a notificaciones de Formulario.
* La lista de leads se marca como `is_converted: true` — a partir de este momento deja de aparecer en [Listar listas de leads](/es/api-reference/management-api/leads/list) o [Listar listas de leads activas](/es/api-reference/management-api/leads/active-list), y las ediciones/entradas/exportaciones adicionales pasan por los endpoints de Formularios en su lugar.

<Warning>
  Esto no es idempotente de forma amigable: llamar a la conversión por segunda vez en una lista de leads ya convertida devuelve `404`, ya que la búsqueda filtra por listas no convertidas. No hay "deshacer" — verifique `is_converted` (mediante [Obtener una lista de leads](/es/api-reference/management-api/leads/retrieve), que devolverá `404` una vez convertida) antes de reintentar.
</Warning>

`400` bajo `data` si los datos del formulario transformado fallan inesperadamente la validación del esquema de Formulario (un caso límite poco común por desviación de forma, no algo que una lista de leads bien formada debería activar).

## Relacionado

* [Listar listas de leads](/es/api-reference/management-api/leads/list) — listas de leads elegibles para conversión.
* [Gestión de formularios](/es/api-reference/management-api/forms/create) — dónde reside el recurso convertido después.
* [Resumen de la API de gestión](/es/api-reference/management-api/overview) — el esquema de autenticación y la arquitectura de cuotas a la que pertenece este endpoint.


## OpenAPI

````yaml api-reference/openapi/management-api.json POST /lead/{lead_id}/convert/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.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://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /lead/{lead_id}/convert/:
    post:
      summary: Convert a lead list to a Form
      operationId: convertManagedLeadList
      responses:
        '201':
          description: Converted.
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. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````