---
title: "POST /api/v1/webhooks"
method: POST
path: "/api/v1/webhooks"
tags: ["Webhooks"]
---

# POST /api/v1/webhooks

`POST /api/v1/webhooks`

Create a new webhook subscription for a tenant

## Headers

- `idempotency-key` string, uuid, required — Required for mutating calls. Use a V4 UUID. The server stores the first result for 24h and returns it on subsequent retries with the same key.

## Request body

- CreateWebhookSubscriptionRequest
  - `name` string, required — Webhook subscription name
  - `url` string, uri, required — Webhook endpoint URL
  - `eventTypes` string[], required — Event types to subscribe to
  - `secret` string — Optional webhook signing secret
  - `metadata` Metadata

## Response `200`

Default Response

- CreateWebhookSubscriptionResponse
  - `subscription` WebhookSubscription, required
    - `subscriptionId` string, uuid, required — UUID
    - `name` string, required — Webhook subscription name
    - `url` string, uri, required
    - `eventTypes` string[], required
    - `active` boolean, required — Whether the subscription is active
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `metadata` Metadata

---

[API](https://skmtc.net/stables/apis/stables-api.md) · [All operations](https://skmtc.net/stables/apis/stables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stables/stables-api/revisions/40ed0bdb89e1/schema)