> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zenflow.com.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Suscribite a notificaciones en tiempo real

# Webhooks

Los webhooks te permiten recibir notificaciones HTTP en tiempo real cuando ocurren eventos en ZenFlow.

<Card title="Guía de Webhooks" icon="book" href="/es/guides/webhooks">
  Consulta la guía completa para ver todos los eventos disponibles, payloads de ejemplo y cómo verificar firmas.
</Card>

## Endpoints

| Método | Endpoint    | Descripción                  |
| ------ | ----------- | ---------------------------- |
| POST   | `/webhooks` | Suscribirse a eventos        |
| GET    | `/webhooks` | Listar suscripciones activas |

## Suscribirse a Eventos

Para recibir notificaciones, creá un webhook especificando tu URL y los eventos que te interesan:

```bash theme={null}
POST /api/v1/webhooks
```

```json theme={null}
{
  "name": "Mis notificaciones",
  "url": "https://tu-servidor.com/webhooks/zenflow",
  "events": ["order/created", "order/completed", "stock/updated"]
}
```

### Eventos Disponibles

| Categoría | Eventos                                                                |
| --------- | ---------------------------------------------------------------------- |
| Pedidos   | `order/created`, `order/updated`, `order/cancelled`, `order/completed` |
| Productos | `product/created`, `product/updated`, `product/deleted`                |
| Stock     | `stock/updated`, `stock/low_alert`, `stock/movement_created`           |
| Flujos    | `flow/started`, `flow/completed`, `flow/cancelled`                     |

<Warning>
  Guardá el `secret` devuelto en la respuesta. Lo necesitarás para verificar las firmas. No se mostrará nuevamente.
</Warning>

## Respuesta

```json theme={null}
{
  "success": true,
  "data": {
    "id": "wh_abc123",
    "name": "Mis notificaciones",
    "url": "https://tu-servidor.com/webhooks/zenflow",
    "events": ["order/created", "order/completed", "stock/updated"],
    "secret": "whsec_xxxxxxxxxxxxxxxx",
    "active": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}
```