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

# Crear webhook

> Registra un nuevo endpoint webhook para recibir notificaciones de eventos.

<ParamField header="x-api-key" type="string" required>
  API key de BOH con scope `admin:webhooks`.
</ParamField>

<ParamField body="url" type="string" required>
  URL HTTPS de destino donde se entregarán los eventos.
</ParamField>

<ParamField body="events" type="string[]" required>
  Array de tipos de evento a suscribir. Usa `["*"]` para todos los eventos.
</ParamField>

<ParamField body="secret" type="string">
  Secreto para firmar los payloads (recomendado). Se usa para verificar la cabecera `x-boh-signature`.
</ParamField>

<RequestExample>
  ```json theme={null}
  {
    "url": "https://mi-sistema.com/webhooks/boh",
    "events": ["inventory_transaction.completed", "purchase_order.status_changed"],
    "secret": "mi_secreto_webhook_super_seguro"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "wep_01j5k...",
    "url": "https://mi-sistema.com/webhooks/boh",
    "events": ["inventory_transaction.completed", "purchase_order.status_changed"],
    "status": "ACTIVE"
  }
  ```
</ResponseExample>