> For the complete documentation index, see [llms.txt](https://docs.giro.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/cadastro-webhook.md).

# Cadastro de Webhook

Esta seção documenta o **CRUD do cadastro de webhook** do originator autenticado. O originator é identificado pelo claim do JWT — não é necessário passar o `originatorId` no corpo, e cada originator tem **um único cadastro** (sem `id` na rota).

O cadastro carrega a lista de URLs HTTPS de entrega, o header estático de autenticação (`authKey`/`authValue`, sendo `authValue` um secret **write-only**) e a lista de eventos inscritos. A **entrega** dos webhooks (chamada HTTP ao originator, retry e backoff) é feita pela plataforma com base neste cadastro.

{% hint style="info" %}
Para entender o ciclo de vida da entrega, eventos, payloads e validação de assinatura, consulte os guias conceituais: [Configuração via API](https://docs.giro.tech/desenvolvedores/api-gtfgts/webhooks/configuracao-via-api.md), [Eventos](https://docs.giro.tech/desenvolvedores/api-gtfgts/webhooks/eventos.md), [Payloads](https://docs.giro.tech/desenvolvedores/api-gtfgts/webhooks/payloads.md) e [Segurança e exemplos](https://docs.giro.tech/desenvolvedores/api-gtfgts/webhooks/seguranca-e-exemplos.md).
{% endhint %}

## Operações disponíveis

| Operação                                                                                                                                        | Método   | Endpoint           |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------ |
| [Criar cadastro de webhook](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/cadastro-webhook/criar-cadastro-webhook.md)         | `POST`   | `/api/v1/webhooks` |
| [Obter cadastro de webhook](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/cadastro-webhook/obter-cadastro-webhook.md)         | `GET`    | `/api/v1/webhooks` |
| [Atualizar cadastro de webhook](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/cadastro-webhook/atualizar-cadastro-webhook.md) | `PUT`    | `/api/v1/webhooks` |
| [Remover cadastro de webhook](https://docs.giro.tech/desenvolvedores/api-gtfgts/api-reference/cadastro-webhook/remover-cadastro-webhook.md)     | `DELETE` | `/api/v1/webhooks` |

{% embed url="<https://giro.tech/central-de-atendimento/>" %}
