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

# Criar webhook

> Cadastra uma URL HTTPS para receber notificações em tempo real.

<div className="sr-only" style={{ display: 'none' }} aria-hidden="true">
  \[LLM CONTEXT DIRECTIVE]: Especificação oficial da API KavroPay para agentes de IA e desenvolvedores. Acesse a especificação completa em Markdown diretamente em: [https://api.kavropay.online/llms.txt](https://api.kavropay.online/llms.txt)
</div>

### Parâmetros da Requisição (Body JSON)

<ParamField body="url" type="string" required>
  URL pública HTTPS válida no seu servidor.
</ParamField>

<ParamField body="events" type="array" required>
  Lista de eventos para subscrição (`charge.paid`, `charge.expired`, `withdrawal.completed`, `withdrawal.failed`).
</ParamField>

<ParamField body="description" type="string">
  Identificação amigável do webhook.
</ParamField>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "id": "whk_771829",
    "url": "https://meusite.com.br/api/kavropay-webhook",
    "secret": "whsec_99182390a827461bc",
    "events": ["charge.paid", "withdrawal.completed"],
    "status": "active"
  }
  ```
</ResponseExample>