Webhooks

Los eventos

Evento	Cuándo
contact.created	Se creó un contacto
contact.updated	Cambió un contacto
card.created	Se creó una ficha
card.updated	Cambió una ficha
card.stage_changed	Una ficha cambió de etapa

Avisan igual venga el cambio de donde venga: la app, la API, un formulario, un mensaje que entra o un agente IA.

Crear un webhook

Los dueños y administradores los crean en Integraciones › Para desarrolladores › Webhooks: la dirección, los eventos y una descripción. Al crearlo te damos el secreto para verificar la firma, que se ve una sola vez. También se pueden crear por la API, con POST /v1/webhooks: es lo que hacen Zapier y Make.

La dirección tiene que ser https:// a un dominio público (puerto 443).

Qué llega

Cada aviso lleva el contacto o la ficha completos, como los devuelve la API, y en los *.updated, qué campo cambió:

{
  "id": "6f0c2a1e-…",
  "type": "contact.updated",
  "timestamp": "2026-11-10T15:04:05.123Z",
  "data": { "id": "…", "name": "Juan Pérez", "emails": [], "customFields": {} },
  "changedFields": ["name"]
}

El orden no está garantizado: usa timestamp, que es la hora del cambio. Van firmados: mira cómo verificar la firma.

Reintentos

Cuenta como entregado un 2xx antes de los 10 segundos. Si tu sistema no responde, reintentamos 8 veces durante unas 44 horas. Un 410 apaga el webhook; 3 días seguidos fallando también, y te avisamos.

En Webhooks ves cada entrega con su respuesta, y puedes reenviarla o mandar una de prueba.