Create a listing

Scope: propose. Images must be TraydStar storage URLs (upload via the web app) or omitted for a placeholder.

post/api/v1/listings

Request

  • Base URL: https://traydstar.com
  • URL: https://traydstar.com/api/v1/listings
  • Auth: HTTP bearer

Request body

titlestring required
descriptionstring required
type'GOOD' | 'SERVICE' | 'BOTH' required
category'Cameras & Photo' | 'Electronics' | 'Collectibles' | 'Sports & Outdoors' | 'Home & Garden' | 'Clothing & Accessories' | 'Books & Media' | 'Vehicles & Parts' | 'Art & Crafts' | 'Other Goods' | 'Design Services' | 'Tech Services' | 'Creative Services' | 'Professional Services' | 'Home Services' | 'Other Services' required
subcategorystring

Optional. Allowed only for categories with subcategories. Cameras & Photo: Camera Bodies, Lenses, Film Cameras, Lighting & Flash, Tripods & Support, Bags & Accessories, Video & Drones.

condition'NEW' | 'LIKE_NEW' | 'GOOD' | 'FAIR' | 'POOR'
imagesstring[]
want_tagsstring[]
want_descriptionstring
stated_value_usdnumber
kind'offer' | 'wanted'
pickupboolean
shipsboolean
location_citystring
draftboolean

Save without publishing.

Response

listing_id of the created listing.

listing_idstring uuid required

Changes

No recorded changes to this operation across all 1 revision of this API.