---
title: "Create a listing"
method: POST
path: "/api/v1/listings"
---

# Create a listing

`POST /api/v1/listings`

## Request

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

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

## Request body

- object
  - `title` string, required
  - `description` string, 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
  - `subcategory` string: 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'
  - `images` string[]
  - `want_tags` string[]
  - `want_description` string
  - `stated_value_usd` number
  - `kind` 'offer' | 'wanted'
  - `pickup` boolean
  - `ships` boolean
  - `location_city` string
  - `draft` boolean: Save without publishing.

## Response `201`

listing_id of the created listing.

- object
  - `listing_id` string, uuid, required

## Other responses

- `default`: Error.

---

[API](https://skmtc.dev/traydstar/apis/traydstar-api.md) · [All operations](https://skmtc.dev/traydstar/apis/traydstar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/traydstar/apis/traydstar-api/revisions/641f54d9786b?raw)