curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
Webhooks de leads
Créer un webhook de liste de leads
POST /lead//webhook/
POST
/
lead
/
{lead_id}
/
webhook
/
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
Ajoute un webhook à une liste de leads, appelé avec la charge utile de l’entrée à chaque nouvelle soumission de formulaire.
Nécessite une clé d’API de gestion avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX) et la permission LEAD_GENERATION_WEBHOOK_CAN_ADD, envoyée comme valeur brute de l’en-tête Authorization — voir la présentation de l’API de gestion.string
requis
Le
lead_id de la liste de leads.string
requis
L’URL cible du webhook, jusqu’à 500 caractères.
curl --request POST \
--url 'https://api.scanova.io/lead/L9c2f4a1e/webhook/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{ "url": "https://example.com/lead-webhook" }'
{ "id": 7, "url": "https://example.com/lead-webhook", "created": "2026-09-08T10:00:00+05:30", "modified": "2026-09-08T10:00:00+05:30" }
403 si le quota de webhooks par liste de leads du plan du compte est épuisé :
403
{ "detail": "You have exhausted your limit of 5 webhooks.", "limit": 5 }
404 si lead_id n’appartient pas à ce compte.
Voir aussi
- Lister les webhooks d’une liste de leads — voir ce qui est déjà configuré.
- Mettre à jour un webhook de liste de leads — modifier l’URL d’un webhook.
- Présentation de l’API de gestion — 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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Réponse
201
Webhook created.
Cette page vous a-t-elle été utile ?