Create a Warehouse

warning

Multiple Warehouse Warning

When calling this endpoint, we do not match this to a previous warehouse. We allow you to create duplicates; however, if you create a shipment without a warehouse_id we will match the warehouse to the first match in the database.

Warehouses have many uses, they're necessary for manifests and also necessary if you would like to provide a different return address for a returns department that is in a different location.

Example

POST /v1/warehouses

curl -iX POST https://api.shipengine.com/v1/warehouses \
-H 'Content-Type: application/json' \
-H 'API-Key: __YOUR_API_KEY_HERE__' \
-d '
{
  "name": "Zero Cool HQ",
  "origin_address": {
     "name": "Dade Murphy",
     "phone": "512-485-4282",
     "company_name": "Zero Cool",
     "address_line1": "345 Chambers Street",
     "address_line2": "Suite 100",
     "city_locality": "New York City",
     "state_province": "NY",
     "postal_code": "10282",
     "country_code": "US",
  },
  "return_address": {
     "name": "Dade Murphy",
     "phone": "512-485-4282",
     "company_name": "Zero Cool Returns",
     "address_line1": "345 Chambers Street",
     "address_line2": "Suite 100",
     "city_locality": "New York City",
     "state_province": "NY",
     "postal_code": "10282",
     "country_code": "US",
  }
}'

{
  "warehouse_id": "se-277331",
  "name": "Zero Cool HQ",
  "created_at": "2018-02-12T23:48:15.387Z",
  "origin_address": {
    "name": "Dade Murphy",
    "phone": "512-485-4282",
    "company_name": "Zero Cool",
    "address_line1": "345 Chambers Street",
    "address_line2": "Suite 100",
    "address_line3": null,
    "city_locality": "New York City",
    "state_province": "NY",
    "postal_code": "10282",
    "country_code": "US",
    "address_residential_indicator": "unknown"
  },
  "return_address": {
    "name": "Dade Murphy",
    "phone": "512-485-4282",
    "company_name": "Zero Cool Returns",
    "address_line1": "345 Chambers Street",
    "address_line2": "Suite 100",
    "address_line3": null,
    "city_locality": "New York City",
    "state_province": "NY",
    "postal_code": "10282",
    "country_code": "US",
    "address_residential_indicator": "unknown"
  }
}