#Создать склад

POST /v1/warehouses

Создаёт новый склад. Поля передаются плоско в корне JSON — без обёртки fields.

#Поля запроса (body)

Параметр Тип Обяз. Описание
title string да Название склада
address string да Адрес склада
active string нет Активность: "Y" / "N". По умолчанию "Y"
issuingCenter string нет Пункт выдачи заказов: "Y" / "N". По умолчанию "N"
description string нет Описание склада
phone string нет Контактный телефон
email string нет Контактная почта
schedule string нет Режим работы — произвольный текст
sort number нет Порядок сортировки. По умолчанию 100
code string нет Символьный код
xmlId string нет Внешний идентификатор для синхронизации
gpsN number нет Географическая широта
gpsS number нет Географическая долгота
userId number нет Ответственный сотрудник — идентификатор из `GET /v1/users`

#Примеры

#curl — личный ключ

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/warehouses" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Основной склад",
    "address": "г. Москва, ул. Складская, 1",
    "active": "Y"
  }'

#curl — OAuth-приложение

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/warehouses" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Основной склад",
    "address": "г. Москва, ул. Складская, 1",
    "active": "Y"
  }'

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/warehouses', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Основной склад',
    address: 'г. Москва, ул. Складская, 1',
    active: 'Y',
  }),
})

const { success, data } = await res.json()
console.log('ID склада:', data.id)

#JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/warehouses', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Основной склад',
    address: 'г. Москва, ул. Складская, 1',
    active: 'Y',
  }),
})

const { success, data } = await res.json()

#Поля ответа

Возвращается объект созданного склада в поле data.

Поле Тип Описание
id number Идентификатор склада
title string Название склада
address string Адрес склада
active string Активность: "Y" / "N"
issuingCenter string Признак пункта выдачи заказов: "Y" / "N"
description string Описание склада
phone string Контактный телефон
email string Контактная почта
schedule string Режим работы
sort number Порядок сортировки
code string Символьный код
xmlId string Внешний идентификатор
gpsN number Географическая широта
gpsS number Географическая долгота
imageId object Изображение склада: { "id", "url" } или null
userId number Ответственный сотрудник
modifiedBy number Идентификатор пользователя, изменившего склад последним
dateCreate datetime Дата создания
dateModify datetime Дата последнего изменения

#Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": 25,
    "title": "Основной склад",
    "address": "г. Москва, ул. Складская, 1",
    "active": "Y",
    "issuingCenter": "N",
    "description": null,
    "phone": null,
    "email": null,
    "schedule": null,
    "sort": 100,
    "code": null,
    "xmlId": null,
    "gpsN": null,
    "gpsS": null,
    "imageId": null,
    "userId": 1,
    "modifiedBy": 1,
    "dateCreate": "2026-06-02T12:04:24+03:00",
    "dateModify": "2026-06-02T12:04:24+03:00"
  }
}

#Пример ответа при ошибке

400 — не передано обязательное поле:

JSON 
{
  "success": false,
  "error": {
    "code": "MISSING_PARAMS",
    "message": "Required: title (string), address (string)"
  }
}

#Ошибки

HTTP Код Описание
400 MISSING_PARAMS Не передано title либо address
401 TOKEN_MISSING API-ключ не имеет настроенных токенов
403 SCOPE_DENIED API-ключ не имеет скоупа catalog
422 BITRIX_ERROR Битрикс24 отклонил создание (например, недопустимое значение поля)

Полный список общих ошибок API — Ошибки.

#Известные особенности

Значения по умолчанию. Если не передать active, sort и issuingCenter, склад создаётся со значениями active: "Y", sort: 100, issuingCenter: "N". Поля userId и modifiedBy в ответе заполняются текущим пользователем, под которым выпущен ключ.

#Смотрите также