---
title: "Создать вебхук"
method: POST
path: "/v3/webhooks"
tags: ["webhooks"]
---

# Создать вебхук

`POST /v3/webhooks`

## Request

- Base URL: `https://api.rewio.ru`
- URL: `https://api.rewio.ru/v3/webhooks`
- Auth: API key in header `X-API-Key`

Подписаться на события: новые отзывы, новые ответы, конец цикла сбора.

`object_ids` сужает подписку до перечисленных объектов; без него события
приходят по всем вашим. Подпись доставки проверяется секретом аккаунта —
он один на все ваши подписки, см. `GET /v3/webhooks/secret`.

## Request body

- WebhookCreateV3: Создание подписки на события.
  - `target` string, required: HTTPS-адрес, на который приходят события.
  - `object_ids` integer[], nullable: Присылать события только по этим объектам. Не передано — по всем вашим.
  - `event_types` string[], required: Какие события присылать.
  - `bucket_window` string: Как часто собирать события в одну доставку.
  - `filters` FiltersV2: Фильтры доставки (/v2). AND-комбинируются. Канонические имена ``has_text`` / ``has_images`` вместо внутренних ``require_text`` / ``require_images``.
    - `allowed_ratings` integer[]
    - `allowed_sources` string[], nullable
    - `has_text` boolean
    - `has_images` boolean

## Response `201`

Successful Response

- WebhookV3: Подписка на события.
  - `id` integer, required: Идентификатор подписки.
  - `target` string, required: Адрес доставки.
  - `object_ids` integer[], nullable: Объекты, по которым приходят события. `null` — по всем.
  - `event_types` string[], required: События подписки.
  - `bucket_window` string, required: Окно группировки событий в одну доставку.
  - `filters` FiltersV2, required: Фильтры доставки (/v2). AND-комбинируются. Канонические имена ``has_text`` / ``has_images`` вместо внутренних ``require_text`` / ``require_images``.
    - `allowed_ratings` integer[]
    - `allowed_sources` string[], nullable
    - `has_text` boolean
    - `has_images` boolean
  - `is_active` boolean, required: Включена ли подписка.
  - `failure_count` integer, required: Сколько неудачных доставок подряд.
  - `last_failure_at` string, date-time, nullable: Момент последней неудачи (UTC, ISO 8601).
  - `created_at` string, date-time, required: Момент создания подписки (UTC, ISO 8601).
  - `updated_at` string, date-time, required: Момент последнего изменения (UTC, ISO 8601).

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/rewio/apis/review-aggregator.md) · [All operations](https://skmtc.dev/rewio/apis/review-aggregator/llms.txt) · [OpenAPI document](https://skmtc.dev/rewio/apis/review-aggregator/revisions/9222b6cf28a5?raw)