API Clay: Webhook

Configurar Webhook de sincronización de movimientos bancarios

El webhook de sincronización permite que Clay envíe notificaciones automáticas a tu sistema cada vez que se crea o elimina un movimiento bancario, sin necesidad de consultar nuestras APIs de forma periódica.

¿Para qué te sirve?

Te permite mantener tus sistemas sincronizados en tiempo real. Reduce llamadas innecesarias a la API, mejora tiempos de respuesta y asegura que siempre trabajes con información bancaria actualizada.

Paso a paso

Activar un webhook en Clay

• Ingresa a Ajustes Generales > Configuración > Webhook de sincronización.
• Haz clic en Agregar Webhook.

• Ingresa la URL (endpoint) que recibirá las notificaciones.
• Ingresa un token de seguridad (webhook key) si deseas autenticación.
• Agrega una descripción (opcional).
• Presiona Validar para comprobar que la URL responde correctamente.
• Si la validación es exitosa, haz clic en Guardar.

Qué puede pasar después

• Cada vez que se registre un nuevo movimiento o se elimine uno existente, Clay enviará una notificación HTTP POST al endpoint configurado.
• El endpoint debe responder HTTP 200 para confirmar la recepción correcta.
• Si la URL no responde correctamente, la notificación se considerará fallida.

Estructura de la notificación

Cada notificación incluye la siguiente información:

• rut_empresa: RUT de la empresa asociada.
• numero_cuenta: Número de la cuenta bancaria.
• banco: Nombre del banco.
• cantidad_nuevos_movimientos: Cantidad de movimientos agregados.
• movimientos: Listado de nuevos movimientos.
• cantidad_movimientos_eliminados: Cantidad de movimientos eliminados.
• movimientos_eliminados: Listado de movimientos eliminados.

Ejemplo de payload recibido:

{
  "rut_empresa": "12345678-9",
  "numero_cuenta": "123456789",
  "banco": "Chile Banconexion",
  "cantidad_nuevos_movimientos": 1,
  "movimientos": [{
      "id": "68f292fa213673dac2bb461117607657365753",
      "monto": 93975.0,
      "descripcion": "Traspaso De: Clay",
      "fecha": "2025-10-17 23:59:59.999999+00:00",
      "abono": true}],
  "cantidad_movimientos_eliminados": 0,
  "movimientos_eliminados": []
}

Autenticación del webhook

Para asegurar que las notificaciones provienen de Clay, puedes configurar un token de autenticación.

• El token se define al crear el webhook.
• Clay enviará el token en todas las solicitudes mediante el header:

x-webhook-key: <token-definido-por-el-usuario>

Tu sistema debe validar que este valor coincida con el token registrado.

Si no se configura un token, las notificaciones se enviarán sin autenticación adicional.

Errores comunes o consideraciones importantes

• El endpoint debe responder HTTP 200 o la notificación se considerará fallida.
• Una URL inválida o caída impedirá la recepción de eventos.
• La autenticación es opcional, pero altamente recomendada en ambientes productivos.

Relación con otros artículos

• Integraciones vía API en Clay
• Gestión bancaria y movimientos
• Importación y sincronización de cartolas

Actualizado el: 09/02/2026