# Crear un webhook

> Endpoint POST /webhooks de la API de Proteside: parámetros, cuerpo de la solicitud, respuestas y ejemplos de código.

URL: https://docs.proteside.com/es/docs/api/reference/webhooks/createWebhook

## Método y ruta

`POST /webhooks`

Crea un canal de notificación de tipo `webhook` (formato `json`), `slack` o `teams`. Si se omite `secret`, se genera uno; se devuelve **una sola vez** en esta respuesta. Las entregas se firman con `X-Proteside-Signature: t=<unix>,v1=<hex hmac_sha256(secret, t + "." + rawBody)>` y se reintentan 3 veces (1 min, 10 min, 60 min).

## Parámetros

- `org_id` (query, `string`): Solo socios (`orgs:manage`): actúa sobre esta organización hija. También se puede enviar como `org_id` en cuerpos JSON.
- `Idempotency-Key` (header, `string`): Reproduce la respuesta original durante 24 h

## Cuerpo de la solicitud

- `url` (`string`), obligatorio: Solo https
- `secret` (`string`): Omítelo para que se genere uno
- `format` (`"json" | "slack" | "teams"`)
- `name` (`string`)
- `store_id` (`string`)
- `events` (`array,null`)
- `min_severity` (`"critical" | "high" | "medium" | "low" | "info"`)
- `active` (`boolean`)

## Respuestas

- `201`: Webhook con secret que se muestra una sola vez
- `400`: Error de validación

Especificación OpenAPI completa: https://app.proteside.com/api/v1/openapi.json
