A description string of the product for sale in the listing.
Optionalimage_An array of numeric image IDs of the images in a listing, which can include up to 10 images.
Optionalis_When true, a buyer may contact the seller for a customized order. The default value is true when a shop accepts custom orders. Does not apply to shops that do not accept custom orders.
Optionalis_When true, this listing is personalizable.
Optionalis_When true, tags the listing as a supply product, else indicates that it's a finished product. Helps buyers locate the listing under the Supplies heading. Requires 'who made' and 'when made'.
Optionalis_When true, applicable shop tax rates apply to this listing at checkout.
Optionalitem_A string defining the units used to measure the dimensions of the product.
Optionalitem_The numeric height of the product measured in units set in 'item dimensions unit'.
Optionalitem_The numeric length of the product measured in units set in item dimensions unit.
Optionalitem_The numeric weight of the product measured in units set in item weight unit.
Optionalitem_A string defining the units used to measure the weight of the product.
Optionalitem_The numeric width of the product measured in units set in 'item dimensions unit'.
OptionalmaterialsA array of material strings for materials used in the product. Valid materials strings contain only letters, numbers, and whitespace characters. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
OptionaloccasionA string indicating an occassion for which this product would make an appropriate gift.
The positive non-zero price of the product. (Sold product listings are private) Note: The price is the minimum possible price.
Optionalprocessing_The maximum number of days required to process this listing.
Optionalprocessing_The minimum number of days required to process this listing.
The positive non-zero number of products available for purchase in the listing.
OptionalrecipientA string indicating a person for whom this product would make an appropriate gift.
The numeric ID of the shipping profile associated with the listing.
Optionalshop_The numeric ID of the shop section for this listing.
OptionalstylesAn array of style strings for this listing, each of which is free-form text string such as Formal, or Steampunk. A Listing may have up to two styles. Valid style strings contain only letters, numbers, and whitespace characters. (regex: /[^\p{L}\p{Nd}\p{Zs}]/u)
OptionaltagsAn array of tag strings for the listing. Valid tag strings contain only letters, numbers, whitespace characters, -, ', ™, ©, and ®. (regex: /[^\p{L}\p{Nd}\p{Zs}-'™©®]/u)
The numeric taxonomy ID of the listing. The seller manages listing taxonomy IDs for their shop.
The listing's title string. Valid title strings contain only letters, numbers, punctuation marks, mathematical symbols, whitespace characters, ™, ©, and ®. (regex: /[^\p{L}\p{Nd}\p{P}\p{Sm}\p{Zs}™©®]/u) You can only use the %, :, & and + characters once each.
Optionalwhen_A string for the era in which the maker made the product in this listing. Helps buyers locate the listing under the Vintage heading. Requires 'is_supply' and 'who_made'.
An string inidcated who made the product. Helps buyers locate the listing under the Handmade heading. Requires 'is_supply' and 'when_made'.
Create a draft listing