МойСклад 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://dev.moysklad.ru/doc/api/remap/1.2/#/dictionaries/webhook#2-vebhuki Вся интеграция одним документом: https://mcp-everything.ru/integrations/moysklad.md