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 gestion — Prospects et formulaires
Créer une lead list
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": []
}
Les lead lists sont la fonctionnalité de capture de leads d’origine de Scanova — une définition de formulaire (
data) rattachée à la page de destination d’un QR code. Listez-les ou créez-en ici.
Les Lead Lists sont une fonctionnalité historique. Le tableau de bord de Scanova oriente désormais les nouveaux cas d’usage de capture de leads vers les Formulaires, qui couvrent le même cas d’usage « collecter des données de visiteurs à partir d’un scan de QR code » avec un outil de création plus performant. Les lead lists existantes continuent de fonctionner, et cet endpoint n’est pas affecté, mais construisez vos nouvelles intégrations sur les Formulaires, sauf si vous devez spécifiquement gérer une lead list préexistante.
Nécessite une clé Management API avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX), envoyée comme valeur brute de l’en-tête Authorization — voir la vue d’ensemble de la Management API.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
requis
Nom de la lead list, jusqu’à 128 caractères.
string
requis
Une chaîne encodée en JSON (et non un objet brut) décrivant les champs du formulaire de lead. Validée par rapport au même schéma de formulaire de lead que celui utilisé par l’outil de création de lead lists du tableau de bord — un JSON mal formé ou une violation de schéma renvoie une erreur 400 sous
data.boolean
défaut:"true"
Indique si le formulaire s’affiche sur la page de destination.
La réponse inclut
data et webhooks (une liste de webhooks de notification {id, url, created, modified}) — des champs présents uniquement dans la structure détaillée renvoyée par la création/récupération, et non dans l’endpoint de liste ci-dessus.Voir aussi
- Lister les lead lists — l’autre opération de ce même endpoint.
- Gestion des formulaires — l’outil de capture de leads actuel et recommandé vers lequel cette fonctionnalité historique est orientée.
- Vue d’ensemble de la Management API — le schéma d’authentification et l’architecture de quotas dont fait partie cet endpoint.
Autorisations
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.
Réponse
201
Lead list created
Cette page vous a-t-elle été utile ?
⌘I