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}]}"
}'
{
"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": []
}
API de gestión — Clientes potenciales y formularios
Crear una lista de leads
POST /lead/
POST
/
lead
/
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}]}"
}'
{
"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": []
}
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í.
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 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.
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.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}]}"
}'
{
"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": []
}
string
requerido
Nombre de la lista de leads, hasta 128 caracteres.
string
requerido
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.boolean
predeterminado:"true"
Si el formulario se renderiza en la página de destino.
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.Relacionado
- Listar listas de leads — la otra operación de este mismo endpoint.
- Gestión de formularios — 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 — el esquema de autenticación y la arquitectura de cuotas de la que forma parte este endpoint.
Autorizaciones
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.
Respuesta
201
Lead list created
¿Esta página le ayudó?
⌘I