# `POST /v1/webhooks`: Subscribe a webhook endpoint

Subscribe an endpoint with an API key, for example from your own code or an automation platform. The URL follows the dashboard's rules (https, no private addresses). The signing secret is returned once. The organization's admins get the same security email as for an endpoint added in the dashboard. Without events, the endpoint receives verification.completed and verification.reviewed. At most 100 endpoints per organization. Needs the webhooks:manage scope.

Body:
- `url` (string, required)
- `events` (array of string)
- `description` (string)

Responses:
- 201: Subscribed.
- 400: Invalid body or a URL that is not allowed.
- 401: Missing, unknown or expired API key.
- 403: The key lacks the scope this call needs, or its IP allowlist refuses the caller.
- 409: The organization already has 100 endpoints.
