> ## Documentation Index
> Fetch the complete documentation index at: https://dev.puppetvendors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Warehouse

> Add a new warehouse / location to the vendor

<Note>
  **V2 Preview** — This endpoint is part of the V2 API preview. Breaking changes may occur.
</Note>

## Overview

Add a new warehouse / location. The server assigns a new numeric `locationId` (one greater than the current max on this vendor). Vendor scope required.

## Request Body

<ParamField body="name" type="string" required>
  Warehouse name (max 200 chars).
</ParamField>

<ParamField body="address1" type="string">Street address line 1 (max 500 chars).</ParamField>
<ParamField body="address2" type="string">Street address line 2 (max 500 chars).</ParamField>
<ParamField body="city" type="string">City (max 200 chars).</ParamField>
<ParamField body="province" type="string">State / province (max 200 chars).</ParamField>
<ParamField body="zip" type="string">Postal code (max 50 chars).</ParamField>
<ParamField body="country" type="string">Country (max 200 chars).</ParamField>

## Response

```json 200 theme={null}
{
  "success": true,
  "data": {
    "locationId": 2,
    "name": "Main Warehouse",
    "address1": "123 Main St",
    "city": "Austin",
    "province": "TX",
    "zip": "78701",
    "country": "US"
  }
}
```

## Example

```bash theme={null}
curl -X POST "https://staging-api.puppetvendors.com/settings/shipping/warehouses" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Main Warehouse",
    "address1": "123 Main St",
    "city": "Austin",
    "province": "TX",
    "zip": "78701",
    "country": "US"
  }'
```

### More Examples

**Create a US warehouse**

```bash theme={null}
curl -X POST "https://staging-api.puppetvendors.com/settings/shipping/warehouses" \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -d '{
    "name": "East Coast Warehouse",
    "address1": "456 Industrial Blvd",
    "address2": "Unit 7B",
    "city": "Newark",
    "province": "NJ",
    "zip": "07102",
    "country": "US",
    "phone": "+1-555-0123",
    "email": "warehouse@acmeco.com",
    "defaultShippingAddress": true
  }'
```