Skip to main content
POST
Create a warehouse

Authorizations

Authorization
string
header
required

Sign in to the admin dashboard and use the resulting ID token for a store and operation you can access. The authenticated dashboard cookie is accepted when the Authorization header is absent. Missing or insufficient access returns 401.

Body

application/json

Validations:

  1. Either 'can_receive_stock' or 'accepts_returns' must be set to true.
  2. 'can_receive_stock' cannot be set to false while the warehouse has existing inventory.
  3. 'is_checkout_point' must be true when the warehouse type is 'retail-store'.
  4. If 'can_receive_stock' is false then 'can_ship_parcel' and 'can_collect' fields should be false. A warehouse cannot be created as default. To become default on update it must have a manual shipping method.
name
string
required

legal name

warehouse_type
enum<string>
required
Available options:
retail-store,
distribution-center
city
string
required
address_line1
string
required
pincode
string
required
state
string
required
country
string
required
contact_phone
string
required

Phone number normalized and validated as ten digits.

Maximum string length: 16
contact_email
string
required
can_receive_stock
boolean
required
can_ship_parcel
boolean
required
can_collect
boolean
required
accepts_returns
boolean
required
is_checkout_point
boolean
required
active
boolean
default:true
gstin
string | null
address_line2
string | null
landmark
string | null
country_code
string
default:+91

International calling code.

Maximum string length: 8
Pattern: ^\+?\d{1,4}$
is_default
boolean
image_url
string | null
seller_warehouse_id
string | null
opening_hours
object
service_provider_id
string[]
write-only

for courier integration.

channel_id
string[]
write-only

Active marketplace sales channel IDs.

Response

OK

message
string
required
success
boolean
required
content
object
required