Create a warehouse

POST https://api.tamio.com/v2/warehouses/create

Creates a new warehouse location with address, contact details, and geographical service areas defining which destinations the warehouse can fulfill orders for.

Body Parameters

label string*

Human-readable name for the warehouse.

custom_id string

Custom identifier for external system integration.

areas_served array of string*

Destination codes this warehouse can fulfill orders for (1–50 unique entries).

country string*

ISO country code where the warehouse is located.

address string*

Street address of the warehouse.

city string*

City where the warehouse is located.

postcode string

Postal or ZIP code.

state string

State or province code.

email string

Contact email for warehouse operations.

telephone string

Contact phone number.

Responses

200 Warehouse created

Warehouse created

status integer

warehouse Warehouse

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
`10239`	Fair use limit reached for warehouses

status integer

error string

error_code integer

401 Missing or invalid API key

Retrieve a warehouse

Update a warehouse

/warehouses/create

1 const response = await fetch("https://api.tamio.com/v2/warehouses/create", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "label": "Main Distribution Center",
9     "custom_id": "WH-001",
10     "areas_served": [
11       "US",
12       "CA",
13       "MX"
14     ],
15     "country": "US",
16     "address": "123 Warehouse Blvd",
17     "city": "Los Angeles",
18     "postcode": "90001",
19     "state": "CA",
20     "email": "[email protected]",
21     "telephone": "+1-555-0100"
22   })
23 });
24 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/warehouses/create")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   label: "Main Distribution Center",
16   custom_id: "WH-001",
17   areas_served: ["US", "CA", "MX"],
18   country: "US",
19   address: "123 Warehouse Blvd",
20   city: "Los Angeles",
21   postcode: "90001",
22   state: "CA",
23   email: "[email protected]",
24   telephone: "+1-555-0100"
25 }.to_json
26 
27 response = https.request(request)
28 puts response.read_body

Responses

{
  "status": 200,
  "warehouse": {
    "id": "aaa14567-e89b-12d3-a456-426614174000",
    "object": "warehouse",
    "label": "Main Distribution Center",
    "custom_id": "WH-001",
    "country": "US",
    "address": "123 Warehouse Blvd",
    "city": "Los Angeles",
    "postcode": "90001",
    "state": "CA",
    "email": "[email protected]",
    "telephone": "+1-555-0100",
    "areas_served": [
      "US",
      "CA",
      "MX"
    ],
    "products": 45,
    "variants": 120,
    "has_notes": true
  }
}

1	const response = await fetch("https://api.tamio.com/v2/warehouses/create", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"label": "Main Distribution Center",
9	"custom_id": "WH-001",
10	"areas_served": [
11	"US",
12	"CA",
13	"MX"
14	],
15	"country": "US",
16	"address": "123 Warehouse Blvd",
17	"city": "Los Angeles",
18	"postcode": "90001",
19	"state": "CA",
20	"email": "[email protected]",
21	"telephone": "+1-555-0100"
22	})
23	});
24	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/warehouses/create")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	label: "Main Distribution Center",
16	custom_id: "WH-001",
17	areas_served: ["US", "CA", "MX"],
18	country: "US",
19	address: "123 Warehouse Blvd",
20	city: "Los Angeles",
21	postcode: "90001",
22	state: "CA",
23	email: "[email protected]",
24	telephone: "+1-555-0100"
25	}.to_json
26
27	response = https.request(request)
28	puts response.read_body