POST /listings

Create a listing

Servers

https://api.reverb.com/api

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Request body fields

Name	Type	Required	Description
`finish`	String	No	Finish, e.g. 'Sunburst'
`inventory`	Integer	No	Number of items available for sale. Reverb will increment and decrement automatically.
`origin_country_code`	String	No	Country of origin/manufacture, ISO code (e.g: US)
`description`	String	No	Product description. Please keep formatting to a minimum.
`year`	String	No	Supports many formats. Ex: 1979, mid-70s, late 90s
`prop_65_warning`	String	No	If your listing contains chemicals that are required to be reported under California Prop 65, please provide your warning statement. We will add the required 'Warning' label and link to California's information page, so you only need to provide the body of the warning. For more information, see https://www.p65warnings.ca.gov/new-proposition-65-warnings
`seller`	Object	No
`seller.paypal_email`	String	No
`make`	String	No	ex: Fender, Gibson
`sku`	String	No	Unique identifier for product
`categories[]`	Array	No
`categories[].uuid`	String	No	UUID of the category for this listing.
`exclusive_channel`	String	No	Currently for users of seller sites only, this allows you to have a listing available only to your seller site by setting this to 'seller_site' Valid values: `"seller_site"` `"reverb"` `"none"`
`storage_location`	String	No	Internal note used by sellers to back reference their catalog system when entering a listing
`seller_cost`	String	No	Cost of goods in your currency as a POSIX-compliant decimal number (internal use only, not shown to buyers)
`shipping`	Object	No
`shipping.local`	Boolean	No	True if you offer local pickup
`shipping.rates[]`	Array	No	List of shipping rates. Set to null to clear rates.
`shipping.rates[].rate`	Object	No
`shipping.rates[].rate.amount`	String	Yes	The amount of money being expressed, as a POSIX-compliant decimal number
`shipping.rates[].rate.currency`	String	Yes	The currency the money will be expressed in Valid values: `"CAD"` `"JPY"` `"MXN"` `"USD"` `"AUD"` `"EUR"` `"GBP"` `"NZD"`
`shipping.rates[].region_code`	String	No	Country code or subregion/superregion code. Full list of codes at /api/shipping/regions
`title`	String	No	Title of your listing
`upc`	String	No	Valid UPC code
`videos[]`	Array	No	List of YouTube video urls. Note: ONLY ONE ALLOWED
`videos[].link`	String	Yes	Valid YouTube url
`sold_as_is`	Boolean	No	This item is sold As-Is and cannot be returned
`price`	Object	No
`price.amount`	String	Yes	The amount of money being expressed, as a POSIX-compliant decimal number
`price.currency`	String	Yes	The currency the money will be expressed in Valid values: `"CAD"` `"JPY"` `"MXN"` `"USD"` `"AUD"` `"EUR"` `"GBP"` `"NZD"`
`shipping_profile_name`	String	No	DEPRECATED, please use shipping_profile_id. Name of a shipping profile
`location`	Object	No
`location.region`	String	No	Ex: IL
`location.locality`	String	No	Ex: Chicago
`location.country_code`	String	No	Ex: US
`model`	String	No	ex: Stratocaster, SG
`preorder_info`	Object	No	Create or update a preorder listing. Requires opt-in. Please contact sales@reverb.com if you would like to activate this feature.
`preorder_info.lead_time_unit`	String	Yes	The unit of time which lead_time is measured in Valid values: `"weeks"` `"days"`
`preorder_info.lead_time`	Integer	No	The amount of time before the item will be ready to ship. When lead_time is submitted it is converted into days and added to the current date to produce `estimated_ship_date` in the response body of the request.
`preorder_info.ship_date`	String	No	The date the item will be available to ship. In the response body of the request, `estimated_ship_date`, will be the same as ship_date. Date must be ISO8601 format - e.g: 2015-04-09T10:52:23-00:00.
`upc_does_not_apply`	Boolean	No	True if a brand new product has no UPC code, ie for a handmade or custom item
`multi_item`	Boolean	No	Specifies if the listing is a bundle of multiple individual items
`condition`	Object	No	Condition
`condition.uuid`	String	Yes	Condition UUID Valid values: `"98777886-76d0-44c8-865e-bb40e669e934"` `"ae4d9114-1bd7-4ec5-a4ba-6653af5ac84d"` `"df268ad1-c462-4ba6-b6db-e007e23922ea"` `"6db7df88-293b-4017-a1c1-cdb5e599fa1a"` `"f7a3f48c-972a-44c6-b01a-0cd27488d3f6"` `"9225283f-60c2-4413-ad18-1f5eba7a856f"` `"7c3f45de-2ae0-4c81-8400-fdb6b1d74890"` `"fbf35668-96a0-4baa-bcde-ab18d6b1b329"` `"ac5b9c1e-dc78-466d-b0b3-7cf712967a48"` `"6a9dfcad-600b-46c8-9e08-ce6e5057921e"`
`photos[]`	Array	No	An array of image URLs. Ex: ['http://my.site.com/image.jpg']
`has_inventory`	Boolean	No	Set true if selling more than one
`shipping_profile_id`	String	No	id of a shop's shipping profile
`offers_enabled`	Boolean	No	Whether the listing accepts negotiated offers (default: true)
`publish`	Boolean	No	Publish your listing if draft
`tax_exempt`	Boolean	No	Listing is exempt from taxes / VAT

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.