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
Crear un webhook de lista 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" }
Añade un webhook a una lista de leads, llamado con la carga útil de la entrada en cada nuevo envío de formulario.
Requiere una clave de API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX) y el permiso LEAD_GENERATION_WEBHOOK_CAN_ADD, enviada como el valor sin procesar del encabezado Authorization — consulte el resumen de la API de gestión.string
requerido
El
lead_id de la lista de leads.string
requerido
La URL de destino del webhook, hasta 500 caracteres.
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 la cuota de webhooks por lista de leads del plan de la cuenta está agotada:
403
{ "detail": "You have exhausted your limit of 5 webhooks.", "limit": 5 }
404 si lead_id no pertenece a esta cuenta.
Relacionado
- Listar webhooks de una lista de leads — ver lo que ya está configurado.
- Actualizar un webhook de lista de leads — cambiar la URL de un webhook.
- 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
201
Webhook created.
¿Esta página le ayudó?