# МойСклад JSON API 1.2: POST /api/remap/1.2/entity/webhook — Создание вебхука

Сочетание `entityType`, `action`, `url` должно быть уникальным; на одно сочетание `entityType` и `action` — до 5 URL для пользователей и 1 для решения.

Документация: https://dev.moysklad.ru/doc/api/remap/1.2/#/dictionaries/webhook#2-vebhuki

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `url` | body | string | да | Адрес для уведомлений |
| `action` | body | string | да | CREATE, UPDATE, DELETE |
| `entityType` | body | string | да | Тип сущности, например customerorder |
| `diffType` | body | string | нет | Формат изменений для UPDATE (отображение изменённых полей) |

## Базовые URL

- Боевой: `https://api.moysklad.ru`
- Все пути начинаются с .: `/api/remap/1.2`

## Авторизация

Тип: Bearer-токен

Два способа: Basic Auth (заголовок `Authorization: Basic` с `логин:пароль` в Base64) или токен доступа (`Authorization: Bearer <AccessToken>`). Токен пользователя выдаёт POST /api/remap/1.2/security/token; для решений из маркетплейса используется токен решения. Лимит запросов зависит от способа: токены решений расходуют лимит медленнее, чем логин/пароль и токен пользователя.

## Нюансы

- Обязательно сжатие: заголовок `Accept-Encoding: gzip`, иначе `415` без тела.
- Ссылки на объекты передаются в формате `meta` (`href`, `type`, `mediaType`).
- Списки возвращают `meta` (`size`, `limit`, `offset`, `nextHref`, `previousHref`) и `rows`; `limit` — до 1000.
- Массив `positions` в запросе на обновление полностью заменяет позиции документа: непереданные удаляются.
- Цены и суммы — в копейках.
- Функции под заголовком `X-Lognex-Remap-Beta-Feature` не подпадают под гарантию неизменности структуры.
- Остаток по заголовкам: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-Lognex-Retry-TimeInterval`, `X-Lognex-Reset`, `X-Lognex-Retry-After`.
- Вебхуки работают только на платных тарифах и в пробный период; при бесплатном тарифе их нельзя создать.
- Есть MCP-сервер документации JSON API (раздел MCP-dev) — он ищет по документации и не выполняет запросы к аккаунту.

## Сценарии с этим методом

- [Получать уведомления об изменениях](https://mcp-everything.ru/integrations/moysklad/scenarios/poluchat-uvedomleniya-ob-izmeneniyah.md)

---

Если этого недостаточно — официальная документация: https://dev.moysklad.ru/doc/api/remap/1.2/#/dictionaries/webhook#2-vebhuki
Вся интеграция одним документом: https://mcp-everything.ru/integrations/moysklad.md