curl --request PATCH \
--url 'https://api.scanova.io/lead/L9c2f4a1e/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "is_active": false }'
{
"id": 205,
"lead_id": "L9c2f4a1e",
"name": "Trade Show Signup",
"is_active": false,
"usage_count": 2,
"entries_count": 14,
"linked_qrs": [
{ "qr_code__id": 88, "qr_code__qrid": "Q7f3a", "qr_code__name": "Booth QR", "qr_code__qr_type": "dy" }
],
"linked_qrs_count": 1,
"created": "2026-08-16T20:44:51.008000+05:30",
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
"webhooks": []
}
Clientes potenciales y formularios
Actualizar una lista de leads
PATCH /lead//
PATCH
/
lead
/
{lead_id}
/
curl --request PATCH \
--url 'https://api.scanova.io/lead/L9c2f4a1e/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "is_active": false }'
{
"id": 205,
"lead_id": "L9c2f4a1e",
"name": "Trade Show Signup",
"is_active": false,
"usage_count": 2,
"entries_count": 14,
"linked_qrs": [
{ "qr_code__id": 88, "qr_code__qrid": "Q7f3a", "qr_code__name": "Booth QR", "qr_code__qr_type": "dy" }
],
"linked_qrs_count": 1,
"created": "2026-08-16T20:44:51.008000+05:30",
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
"webhooks": []
}
Actualiza el nombre, la definición del formulario o el estado activo de una lista de leads.
Se admiten tanto
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.PUT https://api.scanova.io/lead/{lead_id}/
PATCH https://api.scanova.io/lead/{lead_id}/
string
requerido
El
lead_id de la lista de leads. Inmutable — no se puede cambiar mediante este endpoint.string
Nombre de la lista de leads, hasta 128 caracteres.
string
Una cadena codificada en JSON (no un objeto sin procesar) que describe los campos del formulario de leads. Se valida contra el mismo esquema usado en la creación — un JSON con formato incorrecto o una violación del esquema devuelve
400 bajo data.boolean
Si el formulario se muestra en la página de destino.
curl --request PATCH \
--url 'https://api.scanova.io/lead/L9c2f4a1e/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "is_active": false }'
{
"id": 205,
"lead_id": "L9c2f4a1e",
"name": "Trade Show Signup",
"is_active": false,
"usage_count": 2,
"entries_count": 14,
"linked_qrs": [
{ "qr_code__id": 88, "qr_code__qrid": "Q7f3a", "qr_code__name": "Booth QR", "qr_code__qr_type": "dy" }
],
"linked_qrs_count": 1,
"created": "2026-08-16T20:44:51.008000+05:30",
"modified": "2026-09-08T10:12:00.000000+05:30",
"data": "{\"fields\":[{\"type\":\"email\",\"label\":\"Email\",\"required\":true}]}",
"webhooks": []
}
PUT como PATCH. 404 si lead_id no pertenece a esta cuenta.
Relacionado
- Obtener una lista de leads — ver los valores actuales antes de actualizar.
- Eliminar una lista de leads — eliminarla permanentemente.
- Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas a la que pertenece 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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Respuesta
200
Lead list updated.
¿Esta página le ayudó?