---
title: "Создание webhook"
method: POST
path: "/webhooks"
tags: ["Webhooks"]
---

# Создание webhook

`POST /webhooks`

Запрос позволяет подписаться на уведомления о событиях: https://yookassa.ru/developers/using-api/webhooks#events (например, переход платежа в статус succeeded). C помощью webhook можно подписаться только на события платежей и возвратов. Если вы хотите получать уведомления о нескольких событиях, вам нужно для каждого из них создать свой webhook. Для каждого OAuth-токена нужно создавать свой набор webhook.

## Headers

- `Idempotence-Key` string, required

## Request body

- object
  - `event` 'payment.waiting_for_capture' | 'payment.succeeded' | 'payment.canceled' | 'refund.succeeded', required — Событие: https://yookassa.ru/developers/using-api/webhooks#events, которое вы хотите отслеживать.
  - `url` string, required — URL, на который ЮKassa будет отправлять уведомления.

## Response `200`

Запрос успешно обработан

- Webhook — Данные о webhook.
  - `id` string, required — Идентификатор webhook.
  - `event` 'payment.waiting_for_capture' | 'payment.succeeded' | 'payment.canceled' | 'refund.succeeded', required — Событие: https://yookassa.ru/developers/using-api/webhooks#events, о котором уведомляет ЮKassa.
  - `url` string, required — URL, на который ЮKassa отправляет уведомления.

## Other responses

- `400` — Запрос не может быть обработан. Причиной может быть неправильный синтаксис запроса, ошибка в обязательных параметрах запроса, их отсутствие или неподдерживаемый метод.
- `401` — В заголовке Authorization указан неверный ключ.
- `403` — Секретный ключ указан верно, но не хватает прав для совершения операции.
- `500` — Внутренняя ошибка сервера ЮKassa.

---

[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/e79983ebb73d/schema)