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

# POST /webhooks

`POST /webhooks`

Создание webhook

## Headers

- `Idempotence-Key` string, required

## Request body

- CreateWebhookRequest
  - `event` 'payment.waiting_for_capture' | 'payment.succeeded' | 'payment.canceled' | 'refund.succeeded', required
  - `url` string, required — URL для уведомлений.

## Response `200`

The request has succeeded.

- Webhook
  - `id` string, required — Идентификатор webhook.
  - `event` 'payment.waiting_for_capture' | 'payment.succeeded' | 'payment.canceled' | 'refund.succeeded', required
  - `url` string, required — URL для уведомлений.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `403` — Access is forbidden.
- `500` — Server error

## Changes

- **2026-02-14** `fe24d3dfadad` — 1 warning, 11 info
  - removed `subschema #2` from the `event` request property `allOf` list
  - api operation id `Webhooks_create` was added
  - removed the pattern `[0-9a-zA-Z+-_.]{1,64}` from the `header` request parameter `Idempotence-Key`
  - removed `subschema #2` from the response body `allOf` list for the response status `400`
  - …8 more

[Change history](https://skmtc.dev/hexlet/apis/api-kassa/changes/webhooks/post.md)

---

[API](https://skmtc.dev/hexlet/apis/api-kassa.md) · [All operations](https://skmtc.dev/hexlet/apis/api-kassa/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexlet/api-kassa/revisions/fe24d3dfadad/schema)