# Create a webhook

> POST /webhooks endpoint of the Proteside API: parameters, request body, responses and code samples.

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

## Method and route

`POST /webhooks`

Creates a notification channel of type `webhook` (format `json`), `slack` or `teams`. When `secret` is omitted one is generated; it is returned **once** in this response. Deliveries are signed with `X-Proteside-Signature: t=<unix>,v1=<hex hmac_sha256(secret, t + "." + rawBody)>` and retried 3 times (1 min, 10 min, 60 min).

## Parameters

- `org_id` (query, `string`): Partners only (`orgs:manage`): act on this child organization. May also be sent as `org_id` in JSON bodies.
- `Idempotency-Key` (header, `string`): Replays the original response for 24 h

## Request body

- `url` (`string`), required: https only
- `secret` (`string`): Omit to have one generated
- `format` (`"json" | "slack" | "teams"`)
- `name` (`string`)
- `store_id` (`string`)
- `events` (`array,null`)
- `min_severity` (`"critical" | "high" | "medium" | "low" | "info"`)
- `active` (`boolean`)

## Responses

- `201`: Webhook with one-time secret
- `400`: Validation error

Full OpenAPI specification: https://app.proteside.com/api/v1/openapi.json
