Create a listing
create_listingPublish a surplus lot for sale. Requires sign-in with seller access. Provide a title, category, condition, quantity, and price per unit. OAuth discovery: /.well-known/oauth-authorization-server (scope seller:write). Sensitive: requires user approval each time.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"category": "<category>",
"condition": "<condition>",
"quantity": "<quantity>",
"price_per_unit": "<price_per_unit>",
"idempotency_key": "<idempotency_key>"
},
"name": "create_listing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sku | No | Seller's own stock-keeping unit, shown to buyers and used for reconciliation. | |
| name | Yes | Listing title shown to buyers and matched by catalogue search. | |
| category | Yes | Catalogue category. One of: electronics, apparel, home_goods, beauty, sports, kitchenware, office_supplies, toys, food_beverage, tools, other. | |
| quantity | Yes | Units available in this lot. | |
| condition | Yes | Condition of the goods: salvage (sold as-is), customer returns, shelf pulls, overstock, or new or refurbished. | |
| description | No | Listing body copy: condition detail, packaging, lot composition. Buyers filter on its presence and agents summarise it. | |
| price_per_unit | Yes | Price in cents | |
| idempotency_key | Yes | Required. 8–200 characters (letters, digits, . _ : -). The same key returns the original result for 24 hours and is sent to Stripe as Idempotency-Key. | |
| original_retail_price | No | Original retail price in cents |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listing | Yes | ||
| message | Yes | ||
| success | Yes |