---
title: "Create Webhook"
method: POST
path: "/hooks"
tags: ["Webhooks"]
---

# Create Webhook

`POST /hooks`

Creates a new webhook that listens for specific events. Supports optional association with a chat.

## Request body

- object
  - `name` string, required — A human-readable name for the webhook.
  - `events` string[], required — List of event types the webhook should subscribe to.
  - `url` string, uri, required — The target URL to receive the webhook payloads.
  - `chatId` string, nullable, required — The ID of a chat to scope the webhook to.

## Response `200`

Response for status 200

- Webhook
  - `id` string, required — A unique identifier for the webhook.
  - `createdAt` string, date-time, required — The ISO timestamp representing when the chat was created.
  - `name` string, required — A user-defined name to label the webhook.
  - `events` string[], required — List of event types this webhook is subscribed to.
  - `url` string, required — Target URL that receives event payloads for this webhook.
  - `chatId` string, nullable, required — Optional ID of the chat that this webhook is scoped to.

## Other responses

- `401` — Response for status 401
- `403` — Response for status 403
- `404` — Response for status 404
- `422` — Response for status 422
- `500` — Response for status 500

---

[API](https://skmtc.net/vercel/apis/v0-platform-api-beta.md) · [All operations](https://skmtc.net/vercel/apis/v0-platform-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/v0-platform-api-beta/revisions/7c7a496f8022/schema)