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
Actualmente, la activación de Webhooks debe solicitarse directamente a nuestro equipo de soporte.
Para ello, envía un correo a soporte@clay.cl indicando:
- La URL (endpoint) que recibirán las notificaciones.
- El RUT de la empresa asociada.
Nuestro equipo se encargará de habilitar el Webhook y confirmar su activación.
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.
Autorizació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. la clave proporcionada para confirmar que la solicitud proviene de Clay.
Actualizado el: 18/11/2025
¡Gracias!