Skip to main content
POST
Create a warehouse

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

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.
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
number
required

10 digit number without country code.

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
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

array of channel ids

Response

200 - application/json

OK

message
string
success
boolean
content
object