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

string
required
Location name.
string
Primary or Secondary.
string
required
Name of the contact person for this location.
string
required
Contact phone number.
string
required
Street address.
string
required
Area / locality.
string
required
City.
string
required
State / province.
string
Postal / PIN code.
string
Tax registration number (optional).
boolean
default:"false"
When true, this warehouse is offered as a local “Pickup” option at checkout for buyers whose destination country matches.
string
Pickup hours shown at checkout (when local pickup is enabled).
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.