Skip to main content
POST
Create Location
There is no POST /api/v1/locations.json endpoint, and the OAuth App API exposes no location/warehouse CRUD. Inventory locations are managed only through the merchant dashboard surface documented below, which is authenticated with a merchant session (JWT) — not with an OAuth app access token. Installed apps cannot create locations.

Create Location

Inventory locations are modeled as warehouses. A new warehouse is created through the merchant endpoint POST /warehouse/add-warehouse. Authentication: merchant session, allowed roles MERCHANT, STAFF_ADMIN, SUPER_ADMIN, MANAGER. An active store subscription is required; warehouse count is capped by plan tier.

Body Parameters

warehouseName
string
required
Location name.
warehouseType
string
Primary or Secondary.
contactPerson
string
required
Name of the contact person for this location.
mobileNumber
string
required
Contact phone number.
address
string
required
Street address.
area
string
required
Area / locality.
city
string
required
City.
state
string
required
State / province.
pinCode
string
Postal / PIN code.
gstNumber
string
Tax registration number (optional).
localPickupEnabled
boolean
default:"false"
When true, this warehouse is offered as a local “Pickup” option at checkout for buyers whose destination country matches.
pickupHours
string
Pickup hours shown at checkout (when local pickup is enabled).
pickupInstructions
string
Pickup instructions shown at checkout (when local pickup is enabled).

Response

The created warehouse is returned directly under data in the standard response envelope.