Xsolla-logo

Create physical item

post/v2/project/{project_id}/admin/items/physical_good

Adds a new item.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

Project ID.

Example: 44056
Request Body schema: application/json

Object with physical good data.

sku
required
string
object

Object with localizations for item's name. Two-letter lowercase language code.

object

Object with localizations for item's description. Two-letter lowercase language code.

object

Object with localizations for long description of item. Two-letter lowercase language code.

image_url
string
media_list
Array of strings
groups
Array of strings
Array of objects <= 20 items

List of attributes.

Attention. You can't specify more than 20 attributes for the item. Any attempts to exceed the limit result in an error.
Array of objects
Array of objects or null
Array of objects
is_enabled
boolean
is_deleted
boolean
is_free
boolean
order
number
tax_categories
Array of strings
object
Array of objects
object

Weight of the item.

Responses
201

Physical item was successfully created.

401

Basic authentication not passed or wrong. Make sure you used basic authentication or correct credentials.

422

Invalid request.

Request samples
application/json
{
  • "sku": "t-shirt",
  • "name": {
    },
  • "is_enabled": true,
  • "is_free": false,
  • "order": 1,
  • "description": {
    },
  • "attributes": [
    ],
  • "prices": [
    ],
  • "tax_categories": [
    ]
}
Response samples
application/json
{
  • "item_id": 101,
  • "sku": "physical_good_1",
  • "statusCode": 201,
  • "message": "Physical item was successfully created."
}