POST
/
v1
/
listings

Authorizations

X-Treet-Client-Id
string
headerrequired
X-Treet-Authentication-Key
string
headerrequired

Body

application/json
shopId
string
required

Unique Treet shop identifier

condition
enum<string>
required

Item’s condition

Available options:
NEW_WITH_TAGS,
NEW_WITHOUT_TAGS,
EXCELLENT,
GOOD,
MINOR_DEFECT
productDataSourceType
enum<string>
required

Specifies the type of product data source.

  • For SHOPIFY_SKU or SHOPIFY_PRODUCT_VARIANT_ID, productIdentifier must be defined.
  • For MANUAL_PRODUCT_OPTIONS, productOptions field must be defined.
Available options:
SHOPIFY_SKU,
SHOPIFY_PRODUCT_VARIANT_ID,
MANUAL_PRODUCT_OPTIONS
productIdentifier
string

Depending on the productDataSourceType, this is either the Shopify Product Variant ID or the Shopify SKU of the item.

*Required if productDataSourceType is SHOPIFY_SKU or SHOPIFY_PRODUCT_VARIANT_ID

manualProductOptions
object

All information pertaining to a manually listed item for non-Shopify backed items. Title and category are required, and additional fields may be added that help identify the item.

*Required if productDataSourceType is MANUAL_PRODUCT_OPTIONS.

externalIdentifier
string

Unique identifier for the item that can be used to retrieve details about the item later. If this is not passed in, the unique ID that Treet creates must be used instead.

description
string

Treet listing description shown publicly to Treet resale customers.

metadata
object

When listing is purchased, this will be pushed to the Shopify Order as Shopify Custom Attributes to sync to the fulfillment mechanism.

This object is limited to 3 properties and must be either a string or integer.

commercePlatformDomain
string

Only enter this value to override the commerce platform for a shop.

For example, if the shop has more than one Shopify store, you will need to specify the domain of the Shopify store that you want to reference for this listing.

images
object[]

A list of images for this listing

Response

200 - application/json
id
string
required

Unique Treet identifier

url
string
required

Listing link on Treet site