# Criar um webhook

> Endpoint POST /webhooks da API do Proteside: parâmetros, corpo da requisição, respostas e exemplos de código.

URL: https://docs.proteside.com/pt-BR/docs/api/reference/webhooks/createWebhook

## Método e rota

`POST /webhooks`

Cria um canal de notificação do tipo `webhook` (formato `json`), `slack` ou `teams`. Quando `secret` é omitido, um é gerado; ele é retornado **uma única vez** nesta resposta. As entregas são assinadas com `X-Proteside-Signature: t=<unix>,v1=<hex hmac_sha256(secret, t + "." + rawBody)>` e reenviadas 3 vezes (1 min, 10 min, 60 min).

## Parâmetros

- `org_id` (query, `string`): Somente parceiros (`orgs:manage`): atua sobre esta organização filha. Também pode ser enviado como `org_id` em corpos JSON.
- `Idempotency-Key` (header, `string`): Reproduz a resposta original por 24 h

## Corpo da requisição

- `url` (`string`), obrigatório: Somente https
- `secret` (`string`): Omita para que um seja gerado
- `format` (`"json" | "slack" | "teams"`)
- `name` (`string`)
- `store_id` (`string`)
- `events` (`array,null`)
- `min_severity` (`"critical" | "high" | "medium" | "low" | "info"`)
- `active` (`boolean`)

## Respostas

- `201`: Webhook com secret exibido uma única vez
- `400`: Erro de validação

Especificação OpenAPI completa: https://app.proteside.com/api/v1/openapi.json
