curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
API de gestión — Clientes potenciales y formularios
Crear un formulario
POST /forms/
POST
/
forms
/
curl --request POST \
--url 'https://management.scanova.io/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
Los formularios son el generador actual de captura de leads y recopilación de datos de Scanova — más completo que la función heredada de Listas de leads, y la forma recomendada de recopilar datos del visitante desde un escaneo de QR. Listarlos o crearlos aquí.
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/forms/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Booth Signup",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
}
}'
{
"id": 376,
"form_id": "F8a9b0c1d2e3f4g5h",
"name": "Booth Signup",
"created_by": "Docs",
"created": "2026-08-16T20:46:12.554000+05:30",
"form_url": "https://new.scnv.io/form/F8a9b0c1d2e3f4g5h",
"is_active": true,
"usage_count": 0,
"linked_qrs": [],
"entries_count": 0,
"conversion": null,
"modified": "2026-08-16T20:46:12.554000+05:30",
"data": {
"fields": [
{ "type": "text", "label": "Full name", "required": true },
{ "type": "email", "label": "Email", "required": true }
]
},
"theme_id": null,
"theme_config": {},
"theme_overrides": null
}
string
requerido
Nombre del formulario.
object
requerido
El esquema de campos del formulario — validado contra el esquema JSON del generador de formularios de Scanova. Los datos malformados devuelven un 400 bajo
data.string
El
qrid de un código QR para adjuntarlo inmediatamente al crearlo. Solo aplica a códigos QR dinámicos (dy).integer
El ID de un tema activo para estilizar la página pública del formulario. Omítelo para usar el predeterminado de la plataforma.
object
Anulaciones parciales de tokens de tema superpuestas sobre
theme_id (o el tema predeterminado).Vincular más códigos QR después de la creación, o reemplazar por completo el conjunto de vínculos, no forma parte del cuerpo de solicitud de este endpoint — esa es una acción separada de reemplazo de vínculos
qr_ids disponible en el panel/API interna pero no expuesta actualmente aquí.Relacionado
- Listar formularios — la otra operación de este mismo endpoint.
- Gestión de listas de leads — la función heredada de captura de leads que sustituyen los Formularios.
- Listar / crear códigos QR — encuentra el
qridque pasar comoqr_idal crear un formulario. - 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
Form created
¿Esta página le ayudó?
⌘I