---
title: "Create webhook subscription"
method: POST
path: "/webhooks"
---

# Create webhook subscription

`POST /webhooks`

## Request

- Base URL: `https://app.deepvalues.ai/api/v1`
- URL: `https://app.deepvalues.ai/api/v1/webhooks`
- Auth: HTTP bearer

Subscribe to event types. Returns a signing_secret (shown once) used to verify the X-DV-Signature header on every delivery.

## Request body

- object
  - `url` string, uri, required
  - `events` string[], required
  - `label` string

## Response `201`

Created

## Other responses

- `400`: Invalid URL or events
- `429`: Subscription cap reached (10 per key)

---

[API](https://skmtc.dev/deepvalues/apis/deep-values-api.md) · [All operations](https://skmtc.dev/deepvalues/apis/deep-values-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deepvalues/apis/deep-values-api/revisions/3a5c24b7142f?raw)