Рефсейлс API
Справочники

Создать или обновить категорию

PUT
/api/v1/references/categories/external/{externalId}

Категории адресуются внешним ID, как в YML-импорте. Если категории нет, создаёт её: тогда нужен name. Если есть, меняет переданные поля. Родителя задайте через parentExternalId. Право: references:write.

Авторизация

bearerApiKey
headerАвторизацияBearer <rsk_live_…>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API и вебхуки.

externalId*string

ID категории в вашей системе.

Тело запроса

application/json
  1. body
name?string

Название. Обязательно, если категории ещё нет.

Length1 <= length <= 255
parentExternalId?|

externalId родительской категории. null делает категорию корневой.

Ответ

Категория обновлена.

application/json
  1. response
data*
Example Request
curl -X PUT 'https://refsales.ru/api/v1/references/categories/external/string' \  -H 'Content-Type: application/json' \  -d '{  "name": "Свечи",  "parentExternalId": null}'
Example Response
{  "data": {    "id": "5b2e8d1a-7c3f-4e9a-b0d6-1f4a8c2e9b73",    "externalId": "MS-CAT-7",    "name": "Свечи",    "parentId": null,    "createdAt": "2026-05-04T12:00:00.418265+00:00",    "updatedAt": "2026-09-20T08:15:42.418265+00:00"  }}