---
title: "Webhook Create"
method: POST
path: "/api/v1/webhooks"
---

# Webhook Create

`POST /api/v1/webhooks`

## Request

- Base URL: `https://liquidvision.app` (the document declares no server; this is the origin it was published from)
- URL: `https://liquidvision.app/api/v1/webhooks`
- Auth: none declared

Subscribe a URL to alerts (Pro: 3, Bot: 20). type=cascade: a liquidation
cascade just ended, over min_usd and x_normal. type=hl_near_liq: a Hyperliquid
whale position within max_dist_pct of its liquidation price, over min_usd.
type=cluster_sweep: price reached one of the 10 largest modeled liquidation-map
clusters (modeled size over min_usd); sent 3 min later with modeled vs realized USD.
The response carries the signing secret ONCE; verify X-LiquidVision-Signature
= hex HMAC-SHA256(secret, raw body).

## Request body

- WebhookBody
  - `type` string, required
  - `url` string, required
  - `symbol` string, nullable
  - `min_usd` number
  - `x_normal` number
  - `max_dist_pct` number

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/liquidvision/apis/liquidvision-api.md) · [All operations](https://skmtc.dev/liquidvision/apis/liquidvision-api/llms.txt) · [OpenAPI document](https://skmtc.dev/liquidvision/apis/liquidvision-api/revisions/fc97821dbcbe?raw)