---
title: "Create a new webhook"
method: POST
path: "/api/webhooks"
tags: ["webhooks"]
---

# Create a new webhook

`POST /api/webhooks`

## Request body

- CreateWebhookDto
  - `topic` string, required
  - `url` string, uri, required
  - `secret` string, nullable
  - `hidden` boolean
  - `filters` object, nullable, required
    - `channelIds` string[]
  - `headers` object, nullable, required

## Response `201`

Webhook created successfully

---

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