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

# POST /webhook (registro de notificações)

> Registra a URL pública e os eventos desejados. Corpo: TODO (não consta no documento fonte).

## Resumo

* **Método:** `POST`
* **Rota:** `/webhook`
* **Autenticação:** `Authorization: Bearer <seu_api_token>`

A origem informa: "Registre sua URL com `POST /webhook` e a lista de eventos desejados" — **sem** exemplo de corpo.

`TODO: corpo exato, validações, tamanho máximo de URL, se há secret compartilhado além de ECDSA`, limites de taxa de registro.

## Eventos (strings) — referência

* `pix_cash_in` · `pix_cash_out` · `pix_cash_in_reversal` · `pix_cash_out_reversal`

Tabela: [webhooks → comerciante](/webhooks/clearpago-to-merchant).

## HTTP (esperado)

* **2xx/201?** Criado/OK — códigos exatos: `TODO`

## Ver

* [Listar webhooks](/api-reference/list-webhooks)
* [Excluir](/api-reference/delete-webhook)