Webhooks de formularios

Selecciona un bloque Formulario en el editor de KuikPage. En Respuestas nuevas, configura una URL del webhook y, si quieres, activa Envíame cada una por correo. De todas formas, cada respuesta se guarda en la lista Respuestas del panel. Los webhooks de formularios están incluidos desde el plan PRO.

PayloadCopiar link a esta sección

{
  "event": "form.submission",
  "page": { "id": "pg_...", "url": "https://yourbrand.kuik.page" },
  "blockId": "f8a2...",
  "formTitle": "Request a quote",
  "submittedAt": "2026-09-06T14:02:11.482Z",
  "country": "US",
  "data": {
    "Name": "Ada Lovelace",
    "Email": "ada@example.com",
    "Message": "Two pallets, please.",
    "Consent": true
  }
}

Las claves de data son las etiquetas que les diste a los campos, así que un zap de Zapier o un mapeo de CRM se lee con naturalidad. Las reglas del endpoint son las mismas que para los webhooks de escaneos: https y un nombre de host público.

Las entregas de formularios usan la misma cola que los webhooks de escaneos: al menos una vez, con hasta cinco reintentos ante tiempos de espera agotados, respuestas 429 y respuestas 5xx (30 segundos, 2 minutos, 10 minutos y luego una hora), y aparecen con su estado en GET /webhooks/deliveries con eventType form.submission. Cada intento lleva el mismo encabezado X-KuikCode-Delivery; úsalo para eliminar duplicados si después de un éxito lento llega un reintento. Los reintentos leen la URL del webhook actual del bloque en la página publicada, así que si la borras o despublicas la página, se detienen.

Los webhooks de formularios no van firmados, porque la URL vive en el bloque Formulario y no en un endpoint del espacio de trabajo con un secreto. Si necesitas rechazar a desconocidos, usa un segmento secreto en la ruta de tu URL.

Las respuestas también están disponibles con GET /submissions en la API.