Webhooks

Descripcion

Crea un endpoint de webhook y suscripciones de eventos.

Endpoint

• Metodo: POST
• Path: /api/v1/webhooks

Body

• url (string, requerido)
• events (array, requerido)
• enabled (bool, opcional)
• name (string, opcional)
• secret (string, opcional)
• headers (object, opcional)

Eventos soportados (consumo)

• contract.status.changed

Payload ejemplo

{
  "event_type": "contract.status.changed",
  "event_version": "1.0",
  "occurred_at": "2026-02-10T15:30:00Z",
  "company": {"id": 1},
  "idempotency_key": "...",
  "contract_id": 123,
  "external_ref": "cliente-001",
  "from": "ACTIVE",
  "to": "LIMIT_REACHED",
  "reasons": ["API_CALL supero limite (1501/1500)"]
}