Reverb

App · 20 actions

Sell music gear on Reverb: create, update, publish and end listings, ship orders, answer buyers' messages and offers, and leave feedback.

Actions

ActionWhat it does
Accept or decline offerAccept a buyer's offer, or decline it.
Counter offerAnswer a buyer's offer with a price of your own.
Create listingCreate a listing on Reverb.
Delete draft listingDelete a draft listing.
End listingTake a live listing off sale.
Get conversationGet one conversation with its messages, oldest first.
Get listingGet one listing with its price, condition, stock, state and photos.
Get my accountGet the Reverb account the connection acts as: name, email and shop.
Get orderGet one order: buyer, address, amounts, fees, status and tracking.
Leave feedback for buyerRate the buyer of one of your orders, out of 5, with a comment.
List conversationsList your message conversations with buyers, or only unread ones.
List feedbackList feedback buyers left you, or feedback you left.
List my listingsList your listings: live ones, all of them, or drafts, optionally by SKU.
List offersList the active offers buyers have made on your listings.
List ordersList your sales: all, awaiting shipment or unpaid, optionally those updated in a time range.
Mark order picked upMark a local-pickup order as collected by the buyer.
Mark order shippedMark an order shipped with its carrier and tracking number.
Publish listingPut a draft listing on sale.
Send messageReply in a conversation with a buyer.
Update listingChange a listing's details, price or stock.

Accept or decline offer

Accept a buyer's offer, or decline it.

Inputs

Offer IDoffer_idtextRequired
The offer's id, from 'List offers' or the 'New offer' trigger.
AnswerresponsetextRequired
Accept or decline the offer.One of: accept, decline.

Outputs

offer_idtext
The offer answered
responsetext
accept or decline
resultobject
What Reverb answered
Example output
{
  "offer_id": "9001",
  "response": "accept",
  "result": {}
}

Counter offer

Answer a buyer's offer with a price of your own.

Inputs

Offer IDoffer_idtextRequired
The offer's id, from 'List offers' or the 'New offer' trigger.
PricepricenumberRequired
Your price for the item, such as 450.At least 0.
CurrencycurrencytextRequired
The currency of your price, such as USD.
Shipping priceshipping_pricenumber
What you'd charge for shipping, in the same currency.At least 0.

Outputs

currencytext
Its currency
offer_idtext
The offer countered
pricetext
Your price
resultobject
What Reverb answered
Example output
{
  "currency": "USD",
  "offer_id": "9001",
  "price": "450.00",
  "result": {}
}

Create listing

Create a listing on Reverb. It is saved as a draft for you to check, unless 'Publish now' is on.

Inputs

MakemaketextRequired
The brand, such as Fender.
ModelmodeltextRequired
The model, such as Stratocaster.
Titletitletext
The listing's title. Reverb makes one from the make and model if empty.
Categorycategory_uuidtext
Where buyers find it on Reverb.
Conditioncondition_uuidtext
Its condition. B-Stock and Mint (with inventory) need your account to allow them.
Pricepricenumber
The asking price, such as 499.99.At least 0.
Currencycurrencytext
The currency of the price, such as USD. Your shop's currency if empty.
Descriptiondescriptiontext
What buyers read about it.
SKUskutext
Your own stock code for it.
Yearyeartext
When it was made: 1959, 1980s or mid 70s.
Finishfinishtext
Its colour or finish, such as Sunburst.
UPC or EANupctext
The barcode number, for new items.
Photo addressesphotoslist
Web addresses of photos to add, each starting https://. On an update they are added to the listing's photos.
Quantityinventorynumber
How many you have, for new stock you sell more than one of. 0 ends the listing.At least 0.
Accept offersoffers_enabledtrue/false
Whether buyers can make offers.
Shipping profileshipping_profile_idtext
One of the shipping profiles set up in your shop on Reverb.
Publish nowpublishtrue/false
Put it on sale straight away. Off saves a draft. Publishing needs your shop's billing set up.Default: false.

Outputs

listingobject
The listing
listing_idtext
The listing's number
statetext
Its state: draft, live, ended or sold
Example output
{
  "listing": {
    "_links": {
      "web": {
        "href": "https://reverb.com/item/2217395-fender-stratocaster"
      }
    },
    "categories": [
      {
        "full_name": "Electric Guitars / Solid Body",
        "uuid": "dfd39027-d134-4353-b9e4-57dc6be791b9"
      }
    ],
    "condition": {
      "display_name": "Very Good",
      "slug": "very-good",
      "uuid": "ae4d9114-1bd7-4ec5-a4ba-6653af5ac84d"
    },
    "created_at": "2026-10-01T15:17:34-05:00",
    "description": "<p>Plays great.</p>",
    "finish": "Sunburst",
    "has_inventory": false,
    "id": 2217395,
    "inventory": 1,
    "listing_currency": "USD",
    "make": "Fender",
    "model": "Stratocaster",
    "offers_enabled": true,
    "photos": [],
    "price": {
      "amount": "499.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$499",
      "symbol": "$"
    },
    "published_at": "",
    "shop_name": "The Gear Barn",
    "sku": "STRAT-79",
    "state": {
      "description": "Draft",
      "slug": "draft"
    },
    "title": "Fender Stratocaster 1979 Sunburst",
    "year": "1979"
  },
  "listing_id": "2217395",
  "state": "draft"
}

Delete draft listing

Delete a draft listing. Reverb can't delete one that was ever published.

Inputs

Listing IDlisting_idtextRequired
The listing's number or Reverb link, from 'List my listings' or an earlier step.

Outputs

deletedtrue/false
True once deleted
listing_idtext
The draft deleted
Example output
{
  "deleted": true,
  "listing_id": "2217395"
}

End listing

Take a live listing off sale.

Inputs

Listing IDlisting_idtextRequired
The listing's number or Reverb link, from 'List my listings' or an earlier step.
Whyreasontext
Not sold, or sold to a buyer you found on Reverb who paid another way (Reverb then charges its selling fee).One of: not_sold (Not sold), reverb_sale (Sold to a Reverb buyer outside Reverb's checkout). Default: not_sold.

Outputs

endedtrue/false
True once ended
listingobject
The listing, if Reverb returned it
listing_idtext
The listing ended
reasontext
The reason given
Example output
{
  "ended": true,
  "listing": {
    "_links": {
      "web": {
        "href": "https://reverb.com/item/2217395-fender-stratocaster"
      }
    },
    "categories": [
      {
        "full_name": "Electric Guitars / Solid Body",
        "uuid": "dfd39027-d134-4353-b9e4-57dc6be791b9"
      }
    ],
    "condition": {
      "display_name": "Very Good",
      "slug": "very-good",
      "uuid": "ae4d9114-1bd7-4ec5-a4ba-6653af5ac84d"
    },
    "created_at": "2026-10-01T15:17:34-05:00",
    "description": "<p>Plays great.</p>",
    "finish": "Sunburst",
    "has_inventory": false,
    "id": 2217395,
    "inventory": 1,
    "listing_currency": "USD",
    "make": "Fender",
    "model": "Stratocaster",
    "offers_enabled": true,
    "photos": [],
    "price": {
      "amount": "499.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$499",
      "symbol": "$"
    },
    "published_at": "",
    "shop_name": "The Gear Barn",
    "sku": "STRAT-79",
    "state": {
      "description": "Ended",
      "slug": "ended"
    },
    "title": "Fender Stratocaster 1979 Sunburst",
    "year": "1979"
  },
  "listing_id": "2217395",
  "reason": "not_sold"
}

Get conversation

Get one conversation with its messages, oldest first.

Inputs

Conversation IDconversation_idtextRequired
The conversation's id, from 'List conversations' or a trigger.

Outputs

conversationobject
The conversation
messageslist
Its messages, oldest first
Example output
{
  "conversation": {
    "_links": {
      "self": {
        "href": "https://api.reverb.com/api/my/conversations/4410"
      }
    },
    "id": 4410
  },
  "messages": [
    {
      "body": "Is this still available?"
    }
  ]
}

Get listing

Get one listing with its price, condition, stock, state and photos.

Inputs

Listing IDlisting_idtextRequired
The listing's number or Reverb link, from 'List my listings' or an earlier step.

Outputs

listingobject
The listing
listing_idtext
The listing's number
statetext
Its state: draft, live, ended or sold
Example output
{
  "listing": {
    "_links": {
      "web": {
        "href": "https://reverb.com/item/2217395-fender-stratocaster"
      }
    },
    "categories": [
      {
        "full_name": "Electric Guitars / Solid Body",
        "uuid": "dfd39027-d134-4353-b9e4-57dc6be791b9"
      }
    ],
    "condition": {
      "display_name": "Very Good",
      "slug": "very-good",
      "uuid": "ae4d9114-1bd7-4ec5-a4ba-6653af5ac84d"
    },
    "created_at": "2026-10-01T15:17:34-05:00",
    "description": "<p>Plays great.</p>",
    "finish": "Sunburst",
    "has_inventory": false,
    "id": 2217395,
    "inventory": 1,
    "listing_currency": "USD",
    "make": "Fender",
    "model": "Stratocaster",
    "offers_enabled": true,
    "photos": [],
    "price": {
      "amount": "499.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$499",
      "symbol": "$"
    },
    "published_at": "",
    "shop_name": "The Gear Barn",
    "sku": "STRAT-79",
    "state": {
      "description": "Draft",
      "slug": "draft"
    },
    "title": "Fender Stratocaster 1979 Sunburst",
    "year": "1979"
  },
  "listing_id": "2217395",
  "state": "draft"
}

Get my account

Get the Reverb account the connection acts as: name, email and shop.

Inputs

None.

Outputs

accountobject
Your account, as Reverb gives it
Example output
{
  "account": {
    "first_name": "Jo",
    "last_name": "Bloggs",
    "shop_name": "The Gear Barn"
  }
}

Get order

Get one order: buyer, address, amounts, fees, status and tracking.

Inputs

Order numberorder_numbertextRequired
The order's number, from 'List orders', a trigger or an earlier step.

Outputs

orderobject
The order
statustext
Its status, such as paid or shipped
Example output
{
  "order": {
    "_links": {
      "web": {
        "href": "https://reverb.com/my/selling/orders/20"
      }
    },
    "amount_product": {
      "amount": "75.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$75",
      "symbol": "$"
    },
    "amount_tax": {
      "amount": "0.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "FREE",
      "symbol": "$"
    },
    "buyer_first_name": "Another",
    "buyer_id": 10,
    "buyer_last_name": "Buyer",
    "buyer_name": "Another Buyer",
    "created_at": "2026-09-25T13:02:06-04:00",
    "direct_checkout_payout": {
      "amount": "67.85",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$67.85",
      "symbol": "$"
    },
    "local_pickup": false,
    "needs_feedback_for_buyer": false,
    "order_bundle_id": "20",
    "order_number": "20",
    "order_type": "instant",
    "paid_at": "2026-09-25T13:02:08-04:00",
    "payment_method": "direct_checkout",
    "product_id": "20",
    "quantity": 1,
    "selling_fee": {
      "amount": "2.91",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$2.91",
      "symbol": "$"
    },
    "shipped_at": "",
    "shipping": {
      "amount": "8.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$8",
      "symbol": "$"
    },
    "shipping_address": {
      "country_code": "US",
      "display_location": "Shiremanstown, PA, United States",
      "extended_address": "",
      "locality": "Shiremanstown",
      "name": "Another Buyer",
      "phone": "1234567890",
      "postal_code": "17011",
      "region": "PA",
      "street_address": "102 S Tree Ave"
    },
    "shipping_code": "",
    "shipping_method": "shipped",
    "shipping_provider": "",
    "sku": "rev-20",
    "status": "paid",
    "title": "Fulltone Full-Drive 2 Mosfet",
    "total": {
      "amount": "83.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$83",
      "symbol": "$"
    },
    "updated_at": "2026-09-25T13:02:08-04:00"
  },
  "status": "paid"
}

Leave feedback for buyer

Rate the buyer of one of your orders, out of 5, with a comment.

Inputs

Order numberorder_numbertextRequired
The order's number, from 'List orders', a trigger or an earlier step.
RatingratingtextRequired
How it went, out of 5.One of: 5 (5 stars), 4 (4 stars), 3 (3 stars), 2 (2 stars), 1 (1 star).
Commentmessagetext
What to say about the buyer.

Outputs

lefttrue/false
True once left
order_numbertext
The order rated
ratingnumber
The rating given
resultobject
What Reverb answered
Example output
{
  "left": true,
  "order_number": "20",
  "rating": 5,
  "result": {}
}

List conversations

List your message conversations with buyers, or only unread ones. Gets one page; run it again with 'next_page' for more.

Inputs

Unread onlyunread_onlytrue/false
Only conversations with messages you haven't read.
Pagepagenumber
Which page to get, from 1. Use the 'next_page' an earlier run gave.At least 1.
Page sizeper_pagenumber
How many to get per page, 1 to 100. Reverb picks if empty.From 1 to 100.

Outputs

conversationslist
The conversations, as Reverb gives them
countnumber
How many are on this page
next_pagenumber
The next page's number, or 0 when this is the last
pagenumber
The page number given
totalnumber
How many there are in all
total_pagesnumber
How many pages there are
Example output
{
  "conversations": [
    {
      "_links": {
        "self": {
          "href": "https://api.reverb.com/api/my/conversations/4410"
        }
      },
      "id": 4410
    }
  ],
  "count": 1,
  "next_page": 0,
  "page": 1,
  "total": 1,
  "total_pages": 1
}

List feedback

List feedback buyers left you, or feedback you left. Gets one page; run it again with 'next_page' for more.

Inputs

Which feedbackdirectiontext
Feedback you received, or feedback you sent.One of: received (Received (default)), sent. Default: received.
Pagepagenumber
Which page to get, from 1. Use the 'next_page' an earlier run gave.At least 1.
Page sizeper_pagenumber
How many to get per page, 1 to 100. Reverb picks if empty.From 1 to 100.

Outputs

countnumber
How many are on this page
feedbacklist
The feedback, as Reverb gives it
next_pagenumber
The next page's number, or 0 when this is the last
pagenumber
The page number given
totalnumber
How many there are in all
total_pagesnumber
How many pages there are
Example output
{
  "count": 1,
  "feedback": [
    {
      "message": "Great seller!",
      "rating": 5
    }
  ],
  "next_page": 0,
  "page": 1,
  "total": 1,
  "total_pages": 1
}

List my listings

List your listings: live ones, all of them, or drafts, optionally by SKU. Gets one page; run it again with 'next_page' for more.

Inputs

Which listingsstatetext
Live listings, all of them, or drafts only. Defaults to live.One of: live (Live (default)), all (All, including drafts and ended), draft (Drafts only). Default: live.
SKUskutext
Only the listing with this SKU.
Pagepagenumber
Which page to get, from 1. Use the 'next_page' an earlier run gave.At least 1.
Page sizeper_pagenumber
How many to get per page, 1 to 100. Reverb picks if empty.From 1 to 100.

Outputs

countnumber
How many are on this page
listingslist
The listings
next_pagenumber
The next page's number, or 0 when this is the last
pagenumber
The page number given
totalnumber
How many there are in all
total_pagesnumber
How many pages there are
Example output
{
  "count": 1,
  "listings": [
    {
      "_links": {
        "web": {
          "href": "https://reverb.com/item/2217395-fender-stratocaster"
        }
      },
      "categories": [
        {
          "full_name": "Electric Guitars / Solid Body",
          "uuid": "dfd39027-d134-4353-b9e4-57dc6be791b9"
        }
      ],
      "condition": {
        "display_name": "Very Good",
        "slug": "very-good",
        "uuid": "ae4d9114-1bd7-4ec5-a4ba-6653af5ac84d"
      },
      "created_at": "2026-10-01T15:17:34-05:00",
      "description": "<p>Plays great.</p>",
      "finish": "Sunburst",
      "has_inventory": false,
      "id": 2217395,
      "inventory": 1,
      "listing_currency": "USD",
      "make": "Fender",
      "model": "Stratocaster",
      "offers_enabled": true,
      "photos": [],
      "price": {
        "amount": "499.00",
        "amount_cents": 49900,
        "currency": "USD",
        "display": "$499",
        "symbol": "$"
      },
      "published_at": "",
      "shop_name": "The Gear Barn",
      "sku": "STRAT-79",
      "state": {
        "description": "Draft",
        "slug": "draft"
      },
      "title": "Fender Stratocaster 1979 Sunburst",
      "year": "1979"
    }
  ],
  "next_page": 0,
  "page": 1,
  "total": 1,
  "total_pages": 1
}

List offers

List the active offers buyers have made on your listings. Gets one page; run it again with 'next_page' for more.

Inputs

Pagepagenumber
Which page to get, from 1. Use the 'next_page' an earlier run gave.At least 1.
Page sizeper_pagenumber
How many to get per page, 1 to 100. Reverb picks if empty.From 1 to 100.

Outputs

countnumber
How many are on this page
negotiationslist
The offers, as Reverb gives them
next_pagenumber
The next page's number, or 0 when this is the last
pagenumber
The page number given
totalnumber
How many there are in all
total_pagesnumber
How many pages there are
Example output
{
  "count": 1,
  "negotiations": [
    {
      "_links": {
        "self": {
          "href": "https://api.reverb.com/api/my/negotiations/9001"
        }
      },
      "id": 9001
    }
  ],
  "next_page": 0,
  "page": 1,
  "total": 1,
  "total_pages": 1
}

List orders

List your sales: all, awaiting shipment or unpaid, optionally those updated in a time range. Gets one page; run it again with 'next_page' for more.

Inputs

Which ordersgrouptext
All orders, those to ship, or those not paid yet.One of: all (All orders (default)), awaiting_shipment (Awaiting shipment), unpaid. Default: all.
Updated afterupdated_afterdate and time
Only orders changed after this time (all orders only).
Updated beforeupdated_beforedate and time
Only orders changed before this time (all orders only).
Pagepagenumber
Which page to get, from 1. Use the 'next_page' an earlier run gave.At least 1.
Page sizeper_pagenumber
How many to get per page, 1 to 100. Reverb picks if empty.From 1 to 100.

Outputs

countnumber
How many are on this page
next_pagenumber
The next page's number, or 0 when this is the last
orderslist
The orders
pagenumber
The page number given
totalnumber
How many there are in all
total_pagesnumber
How many pages there are
Example output
{
  "count": 1,
  "next_page": 0,
  "orders": [
    {
      "_links": {
        "web": {
          "href": "https://reverb.com/my/selling/orders/20"
        }
      },
      "amount_product": {
        "amount": "75.00",
        "amount_cents": 49900,
        "currency": "USD",
        "display": "$75",
        "symbol": "$"
      },
      "amount_tax": {
        "amount": "0.00",
        "amount_cents": 49900,
        "currency": "USD",
        "display": "FREE",
        "symbol": "$"
      },
      "buyer_first_name": "Another",
      "buyer_id": 10,
      "buyer_last_name": "Buyer",
      "buyer_name": "Another Buyer",
      "created_at": "2026-09-25T13:02:06-04:00",
      "direct_checkout_payout": {
        "amount": "67.85",
        "amount_cents": 49900,
        "currency": "USD",
        "display": "$67.85",
        "symbol": "$"
      },
      "local_pickup": false,
      "needs_feedback_for_buyer": false,
      "order_bundle_id": "20",
      "order_number": "20",
      "order_type": "instant",
      "paid_at": "2026-09-25T13:02:08-04:00",
      "payment_method": "direct_checkout",
      "product_id": "20",
      "quantity": 1,
      "selling_fee": {
        "amount": "2.91",
        "amount_cents": 49900,
        "currency": "USD",
        "display": "$2.91",
        "symbol": "$"
      },
      "shipped_at": "",
      "shipping": {
        "amount": "8.00",
        "amount_cents": 49900,
        "currency": "USD",
        "display": "$8",
        "symbol": "$"
      },
      "shipping_address": {
        "country_code": "US",
        "display_location": "Shiremanstown, PA, United States",
        "extended_address": "",
        "locality": "Shiremanstown",
        "name": "Another Buyer",
        "phone": "1234567890",
        "postal_code": "17011",
        "region": "PA",
        "street_address": "102 S Tree Ave"
      },
      "shipping_code": "",
      "shipping_method": "shipped",
      "shipping_provider": "",
      "sku": "rev-20",
      "status": "paid",
      "title": "Fulltone Full-Drive 2 Mosfet",
      "total": {
        "amount": "83.00",
        "amount_cents": 49900,
        "currency": "USD",
        "display": "$83",
        "symbol": "$"
      },
      "updated_at": "2026-09-25T13:02:08-04:00"
    }
  ],
  "page": 1,
  "total": 1,
  "total_pages": 1
}

Mark order picked up

Mark a local-pickup order as collected by the buyer.

Inputs

Order numberorder_numbertextRequired
The order's number, from 'List orders', a trigger or an earlier step.

Outputs

order_numbertext
The order marked
picked_uptrue/false
True once marked
resultobject
What Reverb answered
Example output
{
  "order_number": "20",
  "picked_up": true,
  "result": {}
}

Mark order shipped

Mark an order shipped with its carrier and tracking number.

Inputs

Order numberorder_numbertextRequired
The order's number, from 'List orders', a trigger or an earlier step.
Carriershipping_providertextRequired
Who is delivering it, such as USPS.
Tracking numbertracking_numbertextRequired
The carrier's tracking number.
Email the buyersend_notificationtrue/false
Send the buyer Reverb's shipped email.

Outputs

order_numbertext
The order marked
resultobject
What Reverb answered
shippedtrue/false
True once marked
Example output
{
  "order_number": "20",
  "result": {},
  "shipped": true
}

Publish listing

Put a draft listing on sale. It needs a make, model, price, condition, category and photo.

Inputs

Listing IDlisting_idtextRequired
The listing's number or Reverb link, from 'List my listings' or an earlier step.

Outputs

listingobject
The listing
listing_idtext
The listing's number
statetext
Its state: draft, live, ended or sold
Example output
{
  "listing": {
    "_links": {
      "web": {
        "href": "https://reverb.com/item/2217395-fender-stratocaster"
      }
    },
    "categories": [
      {
        "full_name": "Electric Guitars / Solid Body",
        "uuid": "dfd39027-d134-4353-b9e4-57dc6be791b9"
      }
    ],
    "condition": {
      "display_name": "Very Good",
      "slug": "very-good",
      "uuid": "ae4d9114-1bd7-4ec5-a4ba-6653af5ac84d"
    },
    "created_at": "2026-10-01T15:17:34-05:00",
    "description": "<p>Plays great.</p>",
    "finish": "Sunburst",
    "has_inventory": false,
    "id": 2217395,
    "inventory": 1,
    "listing_currency": "USD",
    "make": "Fender",
    "model": "Stratocaster",
    "offers_enabled": true,
    "photos": [],
    "price": {
      "amount": "499.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$499",
      "symbol": "$"
    },
    "published_at": "",
    "shop_name": "The Gear Barn",
    "sku": "STRAT-79",
    "state": {
      "description": "Draft",
      "slug": "draft"
    },
    "title": "Fender Stratocaster 1979 Sunburst",
    "year": "1979"
  },
  "listing_id": "2217395",
  "state": "live"
}

Send message

Reply in a conversation with a buyer.

Inputs

Conversation IDconversation_idtextRequired
The conversation's id, from 'List conversations' or a trigger.
MessagemessagetextRequired
What to say.

Outputs

conversation_idtext
The conversation replied in
resultobject
What Reverb answered
senttrue/false
True once sent
Example output
{
  "conversation_id": "4410",
  "result": {},
  "sent": true
}

Update listing

Change a listing's details, price or stock. Only the fields you fill in change.

Inputs

Listing IDlisting_idtextRequired
The listing's number or Reverb link, from 'List my listings' or an earlier step.
Makemaketext
The brand, such as Fender. Leave empty to keep it.
Modelmodeltext
The model, such as Stratocaster. Leave empty to keep it.
Titletitletext
The listing's title. Reverb makes one from the make and model if empty. Leave empty to keep it.
Categorycategory_uuidtext
Where buyers find it on Reverb. Leave empty to keep it.
Conditioncondition_uuidtext
Its condition. B-Stock and Mint (with inventory) need your account to allow them. Leave empty to keep it.
Pricepricenumber
The asking price, such as 499.99. Leave empty to keep it.At least 0.
Currencycurrencytext
The currency of the price, such as USD. Your shop's currency if empty.
Descriptiondescriptiontext
What buyers read about it. Leave empty to keep it.
SKUskutext
Your own stock code for it. Leave empty to keep it.
Yearyeartext
When it was made: 1959, 1980s or mid 70s. Leave empty to keep it.
Finishfinishtext
Its colour or finish, such as Sunburst. Leave empty to keep it.
UPC or EANupctext
The barcode number, for new items. Leave empty to keep it.
Photo addressesphotoslist
Web addresses of photos to add, each starting https://. On an update they are added to the listing's photos.
Quantityinventorynumber
How many you have, for new stock you sell more than one of. 0 ends the listing. Leave empty to keep it.At least 0.
Accept offersoffers_enabledtrue/false
Whether buyers can make offers. Leave empty to keep it.
Shipping profileshipping_profile_idtext
One of the shipping profiles set up in your shop on Reverb. Leave empty to keep it.

Outputs

listingobject
The listing
listing_idtext
The listing's number
statetext
Its state: draft, live, ended or sold
Example output
{
  "listing": {
    "_links": {
      "web": {
        "href": "https://reverb.com/item/2217395-fender-stratocaster"
      }
    },
    "categories": [
      {
        "full_name": "Electric Guitars / Solid Body",
        "uuid": "dfd39027-d134-4353-b9e4-57dc6be791b9"
      }
    ],
    "condition": {
      "display_name": "Very Good",
      "slug": "very-good",
      "uuid": "ae4d9114-1bd7-4ec5-a4ba-6653af5ac84d"
    },
    "created_at": "2026-10-01T15:17:34-05:00",
    "description": "<p>Plays great.</p>",
    "finish": "Sunburst",
    "has_inventory": false,
    "id": 2217395,
    "inventory": 1,
    "listing_currency": "USD",
    "make": "Fender",
    "model": "Stratocaster",
    "offers_enabled": true,
    "photos": [],
    "price": {
      "amount": "499.00",
      "amount_cents": 49900,
      "currency": "USD",
      "display": "$499",
      "symbol": "$"
    },
    "published_at": "",
    "shop_name": "The Gear Barn",
    "sku": "STRAT-79",
    "state": {
      "description": "Draft",
      "slug": "draft"
    },
    "title": "Fender Stratocaster 1979 Sunburst",
    "year": "1979"
  },
  "listing_id": "2217395",
  "state": "draft"
}

On this page