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

# Webhooks

> Registra URLs, recibe eventos en tiempo real y consulta entregas — por API o panel.

<Tip>
  Webhook es la **timbre de tu servidor**: cuando algo cambia en Notifique, la API avisa con un POST JSON a tu URL.
</Tip>

## Registrar por API

Scopes: `webhooks:read` y `webhooks:manage`.

```bash theme={null}
curl -X POST https://api.notifique.dev/v1/webhooks \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi webhook",
    "url": "https://api.tudominio.com/receive",
    "events": ["message.sent", "message.delivered"],
    "instanceIds": []
  }'
```

**Guarda el `secret`** para validar `X-Notifique-Signature`.

## Entregas

| Método | Ruta                                          |
| ------ | --------------------------------------------- |
| GET    | `/v1/webhooks/deliveries`                     |
| GET    | `/v1/webhooks/deliveries/{deliveryId}`        |
| POST   | `/v1/webhooks/deliveries/{deliveryId}/resend` |
| POST   | `/v1/webhooks/{id}/rotate-secret`             |

Guía completa: [Webhooks](/es/guides/webhooks/index).