API Clay: Webhooks
Esta funcionalidad permite recibir notificaciones automáticas cada vez que se registra un nuevo movimiento en Clay, sin necesidad de consultar periódicamente nuestras APIs para verificar actualizaciones.
Las notificaciones se envían mediante solicitudes HTTP POST a una URL (endpoint) que el cliente debe configurar y proporcionar a Clay.
Este endpoint debe retornar 200 en caso de que reciba la notificación con éxito.Cada vez que se genera un nuevo movimiento o se elimina uno existente, Clay enviará una notificación con una estructura que contiene la información necesaria para procesar los cambios en tu sistema.
Activación del Webhook
Debes ingresar a Ajustes Generales > Configuración > Webhook de sincronización
Para agregar un webhook, debes presionar en "Agregar Webhook" y debes ingresar la siguiente información
- La URL (endpoint) que recibirán las notificaciones.
- Token de seguridad (webhook key)
- Descripción (opcional)
Al agregar esta información debes validar que la URL sea correcta en el botón de "Validar"
Luego de que la URL este validada puedes guardar y disfrutar de las notificaciones directas.
Estructura de la Notificación
El contenido enviado en cada notificación incluye los siguientes campos:
Campo | Descripció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 nuevos movimientos agregados |
movimientos | lisado de nuevos movimientos |
cantidad_movimientos_eliminados | cantidad de movimientos eliminados |
movimientos_eliminados | listado de movimientos eliminados |
Ejemplo de notificación:
{
'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': []
}
ℹ️ Nota: Tanto movimientos, como movimientos_eliminados, pueden estar vacíos si no existen nuevos movimientos o eliminaciones en la notificación.
Autenticación
Para asegurar la autenticidad de las notificaciones, Clay ofrece la opción de habilitar autenticación mediante un token definido por el usuario.
Al activar el webhook, el usuario podrá registrar un token propio, que se enviará en todas las solicitudes del webhook a través del siguiente header:
x-webhook-key: <token-definido-por-el-usuario>
El sistema receptor deberá validar que el valor de este header coincida con el token registrado, confirmando así que la notificación proviene de Clay.
Si no se configura un token, las notificaciones se enviarán sin autenticación adicional.
Actualizado el: 19/11/2025
¡Gracias!