Scope: inventory:warehouses.write https://api.alladdin.com/api/v2/warehouses

Creates a new warehouse in your account. Warehouses are locations where you store inventory — each product's stock is tracked per warehouse.
The response returns the new warehouse id. The first warehouse created is automatically set as the default.

Request body

object name string required email string | null optional phone string | null optional mobile string | null optional default boolean optional address object | null optional address string | null city string | null province string | null postal_code string | null country string | null country_code string | null

Request

import requests

url = "https://api.alladdin.com/api/v2/warehouses"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "name": "string",
    "email": "string",
    "phone": "string",
    "mobile": "string",
    "default": false,
    "address": {
        "address": "string",
        "city": "string",
        "province": "string",
        "postal_code": "string",
        "country": "string",
        "country_code": "string"
    }
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Responses

Response

{
  "id": "507f1f77bcf86cd799439011"
}

Success responses

201 Warehouse created application/json object id string

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 422 Validation error application/json 429 Rate limit exceeded application/json

Next →Update a warehouse →