> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ayuda.clay.cl/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# API Clay: Webhook

## ${color}[#2e97a6](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.
### ${color}[#2e97a6](¿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.

### ${color}[#2e97a6](Paso a paso)
#### Activar un webhook en Clay
* Ingresa a **Ajustes Generales > Configuración > Webhook de sincronización**.
* Haz clic en **Agregar Webhook**.
![](https://storage.crisp.chat/users/helpdesk/website/-/4/4/9/d/449dac2f63676000/api_12f5yv5.gif)
* 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**.
|| Desde ese momento, Clay comenzará a enviar notificaciones automáticamente.

### ${color}[#2e97a6](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.

### ${color}[#2e97a6](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": []
}

```
||| ℹ️ Nota: Los campos movimientos y movimientos_eliminados pueden venir vacíos si no hubo cambios en ese evento.

### ${color}[#2e97a6](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**.

### ${color}[#2e97a6](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