---
title: "Create a webhook"
method: POST
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# Create a webhook

`POST /v1/webhooks`

## Request

- Base URL: `https://api.planwire.io`
- URL: `https://api.planwire.io/v1/webhooks`
- Auth: API key in header `X-API-Key`

Register a URL to receive POST requests when new planning applications match your filter. Each delivery is HMAC-SHA256 signed with your webhook secret. Developer keys can create one active webhook scoped to a council or postcode prefix. Production supports up to 100 webhooks, including national coverage; Business supports national webhook workflows subject to fair use.

## Request body

- object
  - `url` string, uri, required
  - `filters` object
    - `councilId` string
    - `postcodePrefix` string
    - `applicationType` string
    - `status` string

## Response `200`

Webhook created

- object
  - `data` Webhook
    - `id` string, uuid
    - `url` string, uri
    - `secret` string
    - `filters` object
      - `councilId` string
      - `postcodePrefix` string
      - `applicationType` string
      - `status` string
    - `active` boolean
    - `created_at` string, date-time

---

[API](https://skmtc.dev/planwire/apis/planwire-uk-planning-data-infrastructure-api.md) · [All operations](https://skmtc.dev/planwire/apis/planwire-uk-planning-data-infrastructure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/planwire/apis/planwire-uk-planning-data-infrastructure-api/revisions/4ccb7f811da9?raw)