---
title: "Create a webhook rule (Home+)"
method: POST
path: "/v1/webhooks"
---

# Create a webhook rule (Home+)

`POST /v1/webhooks`

## Request

- Base URL: `https://voltcast.com/api`
- URL: `https://voltcast.com/api/v1/webhooks`
- Auth: HTTP bearer

## Request body

- object
  - `url` string, uri, required
  - `event` 'auction_published' | 'price_below' | 'price_above' | 'negative_prices' | 'ida_published' | 'unavailability_published', required
  - `zone` string: Home rules are bound to the selected zone and default to it when omitted. Multi-zone plans may omit this field for all zones.
  - `threshold_eur_mwh` number

## Response `201`

Rule created; HMAC signing secret returned exactly once. Deliveries carry X-Voltcast-Signature: t=<unix>,v1=HMAC_SHA256(secret, "t.body").

## Other responses

- `403`: subscription_required | zone_selection_required | zone_not_in_tier | webhooks_require_plan | webhook_rule_limit

---

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