Create a Location

POST 
https://euwest.api.elasticpath.com/v2/inventories/locations

Creates an Inventory Location

Request

application/json

Body

data objectrequired
typeInventoryLocationType (string)
Possible values: [inventory_location]
Example: inventory_location
attributes LocationAttributesrequired
namestringrequired
Possible values: >= 3 characters and <= 1024 characters
Example: Milton Keynes Warehouse
external_refstring
Possible values: >= 3 characters and <= 1024 characters
Example: mk-stock-warehouse-walnut-tree
slugstringrequired
Possible values: non-empty and <= 128 characters
Example: milton-keynes-warehouse
descriptionstring
Possible values: >= 3 characters and <= 1024 characters
Example: Southern dispatch location for all inventory
addressstring[]
Possible values: >= 1, <= 8
geolocation objectnullable
The longitude and latitude of a location.
latdoublerequired
Example: 51.477928
londoublerequired
Example: -0.001545

Responses

201

Success. The location was created successfully

application/json

Schema

Schema

data object
idUUID (string)required
The unique identifier.
Example: 00000000-0000-0000-0000-000000000000
typeInventoryLocationType (string)required
Possible values: [inventory_location]
Example: inventory_location
attributes LocationAttributesrequired
namestringrequired
Possible values: >= 3 characters and <= 1024 characters
Example: Milton Keynes Warehouse
external_refstring
Possible values: >= 3 characters and <= 1024 characters
Example: mk-stock-warehouse-walnut-tree
slugstringrequired
Possible values: non-empty and <= 128 characters
Example: milton-keynes-warehouse
descriptionstring
Possible values: >= 3 characters and <= 1024 characters
Example: Southern dispatch location for all inventory
addressstring[]
Possible values: >= 1, <= 8
geolocation objectnullable
The longitude and latitude of a location.
latdoublerequired
Example: 51.477928
londoublerequired
Example: -0.001545
meta object
timestamps Timestampsrequired
updated_atstring
The date and time a resource was updated.
Example: 2017-01-10T11:41:19.244842Z
created_atstringrequired
The date and time a resource was created.
Example: 2017-01-10T11:41:19.244842Z

Example (auto)

{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "type": "inventory_location",
    "attributes": {
      "name": "Milton Keynes Warehouse",
      "external_ref": "mk-stock-warehouse-walnut-tree",
      "slug": "milton-keynes-warehouse",
      "description": "Southern dispatch location for all inventory",
      "address": [
        "string"
      ],
      "geolocation": {
        "lat": 51.477928,
        "lon": -0.001545
      }
    },
    "meta": {
      "timestamps": {
        "updated_at": "2017-01-10T11:41:19.244842Z",
        "created_at": "2017-01-10T11:41:19.244842Z"
      }
    }
  }
}

Example

{
  "data": {
    "id": "ebc7652d-bb7d-4359-9a83-78f2998208d9",
    "type": "inventory_location",
    "attributes": {
      "name": "Milton Keynes Warehouse",
      "external_ref": "mk-stock-warehouse-walnut-tree",
      "slug": "milton-keynes-warehouse",
      "description": "Southern dispatch location for all inventory",
      "address": [
        "Troughton Supplies",
        "38 Pipernel Grove",
        "Walnut Tree",
        "MK7 4UL"
      ],
      "geolocation": {
        "lat": -90,
        "lon": 180
      }
    }
  }
}

400

Bad request. The request failed validation.

application/json

Schema

Schema

errors object[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": 500,
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

missing-name

{
  "errors": [
    {
      "title": "Validation Error",
      "status": "400",
      "detail": "Your request was invalid"
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://euwest.api.elasticpath.com/v2/inventories/locations");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var content = new StringContent("{\n  \"data\": {\n    \"type\": \"inventory_location\",\n    \"attributes\": {\n      \"name\": \"Milton Keynes Warehouse\",\n      \"external_ref\": \"mk-stock-warehouse-walnut-tree\",\n      \"slug\": \"milton-keynes-warehouse\",\n      \"description\": \"Southern dispatch location for all inventory\",\n      \"address\": [\n        \"string\"\n      ],\n      \"geolocation\": {\n        \"lat\": 51.477928,\n        \"lon\": -0.001545\n      }\n    }\n  }\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://euwest.api.elasticpath.com/v2

Auth

Bearer Token

Body

{
  "data": {
    "type": "inventory_location",
    "attributes": {
      "name": "Milton Keynes Warehouse",
      "external_ref": "mk-stock-warehouse-walnut-tree",
      "slug": "milton-keynes-warehouse",
      "description": "Southern dispatch location for all inventory",
      "address": [
        "string"
      ],
      "geolocation": {
        "lat": 51.477928,
        "lon": -0.001545
      }
    }
  }
}

ResponseClear

Click the Send API Request button above and see the response here!