---
title: "Changes to Create Webhook"
method: POST
path: "/hooks"
---

# Changes to Create Webhook

`POST /hooks`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 48 revisions.

- **2026-07-30** `da68370a2aea`: 8 breaking, 17 info
- **2025-09-08** `9924b1bf0d99`: 1 warning, 1 info
- **2025-08-24** `3521652a43a7`: 1 breaking, 1 info

## Changes

- **2026-07-30** `da68370a2aea`: 8 breaking, 17 info
  - the request property `chatId` became required
  - response property `chatId` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the required property `error` from the response with the `401` status
  - removed the required property `error` from the response with the `403` status
  - removed the required property `error` from the response with the `404` status
  - removed the required property `error` from the response with the `422` status
  - removed the required property `error` from the response with the `500` status
  - removed the required property `object` from the response with the `200` status
  - api operation id `hooks.create` removed and replaced with `webhooks.create`
  - the endpoint scheme security `apiKey` was removed from the API
  - api tag `Webhooks` added
  - api tag `hooks` removed
  - added the media type `application/x-www-form-urlencoded` to the request body
  - added the media type `multipart/form-data` to the request body
  - request property `chatId` list-of-types was widened by adding types `null` to media type `application/json`
  - removed the non-success response with the status `409`
  - removed the non-success response with the status `413`
  - removed the non-success response with the status `429`
  - the response property `chatId` became required for the status `200`
  - added the required property `createdAt` to the response with the `200` status
  - added the required property `message` to the response with the `401` status
  - added the required property `message` to the response with the `403` status
  - added the required property `message` to the response with the `404` status
  - added the required property `message` to the response with the `422` status
  - added the required property `message` to the response with the `500` status
- **2025-09-08** `9924b1bf0d99`: 1 warning, 1 info
  - added the new `message.finished` enum value to the `events/items/` response property for the response status `200`
  - added the new `message.finished` enum value to the request property `events/items/`
- **2025-08-24** `3521652a43a7`: 1 breaking, 1 info
  - removed the enum value `message.finished` of the request property `events/items/`
  - removed the `message.finished` enum value from the `events/items/` response property for the response status `200`

---

[Operation](https://skmtc.dev/vercel/apis/v0-platform-api-beta/docs/hooks/post.md) - [API](https://skmtc.dev/vercel/apis/v0-platform-api-beta.md) - [Page](https://skmtc.dev/vercel/apis/v0-platform-api-beta/changes/hooks/post)