# Reverb

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

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/reverb

## Actions

### Accept or decline offer

Accept a buyer's offer, or decline it.

**Inputs**

- Offer ID (`offer_id`, text, required): The offer's id, from 'List offers' or the 'New offer' trigger.
- Answer (`response`, text, required): Accept or decline the offer. One of: `accept`, `decline`.

**Outputs**

- `offer_id` (text): The offer answered
- `response` (text): accept or decline
- `result` (object): What Reverb answered

**Example output**

```json
{
  "offer_id": "9001",
  "response": "accept",
  "result": {}
}
```

### Counter offer

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

**Inputs**

- Offer ID (`offer_id`, text, required): The offer's id, from 'List offers' or the 'New offer' trigger.
- Price (`price`, number, required): Your price for the item, such as 450. At least 0.
- Currency (`currency`, text, required): The currency of your price, such as USD.
- Shipping price (`shipping_price`, number): What you'd charge for shipping, in the same currency. At least 0.

**Outputs**

- `currency` (text): Its currency
- `offer_id` (text): The offer countered
- `price` (text): Your price
- `result` (object): What Reverb answered

**Example output**

```json
{
  "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**

- Make (`make`, text, required): The brand, such as Fender.
- Model (`model`, text, required): The model, such as Stratocaster.
- Title (`title`, text): The listing's title. Reverb makes one from the make and model if empty.
- Category (`category_uuid`, text): Where buyers find it on Reverb.
- Condition (`condition_uuid`, text): Its condition. B-Stock and Mint (with inventory) need your account to allow them.
- Price (`price`, number): The asking price, such as 499.99. At least 0.
- Currency (`currency`, text): The currency of the price, such as USD. Your shop's currency if empty.
- Description (`description`, text): What buyers read about it.
- SKU (`sku`, text): Your own stock code for it.
- Year (`year`, text): When it was made: 1959, 1980s or mid 70s.
- Finish (`finish`, text): Its colour or finish, such as Sunburst.
- UPC or EAN (`upc`, text): The barcode number, for new items.
- Photo addresses (`photos`, list): Web addresses of photos to add, each starting https://. On an update they are added to the listing's photos.
- Quantity (`inventory`, number): How many you have, for new stock you sell more than one of. 0 ends the listing. At least 0.
- Accept offers (`offers_enabled`, true/false): Whether buyers can make offers.
- Shipping profile (`shipping_profile_id`, text): One of the shipping profiles set up in your shop on Reverb.
- Publish now (`publish`, true/false): Put it on sale straight away. Off saves a draft. Publishing needs your shop's billing set up. Default: `false`.

**Outputs**

- `listing` (object): The listing
- `listing_id` (text): The listing's number
- `state` (text): Its state: draft, live, ended or sold

**Example output**

```json
{
  "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 ID (`listing_id`, text, required): The listing's number or Reverb link, from 'List my listings' or an earlier step.

**Outputs**

- `deleted` (true/false): True once deleted
- `listing_id` (text): The draft deleted

**Example output**

```json
{
  "deleted": true,
  "listing_id": "2217395"
}
```

### End listing

Take a live listing off sale.

**Inputs**

- Listing ID (`listing_id`, text, required): The listing's number or Reverb link, from 'List my listings' or an earlier step.
- Why (`reason`, text): 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**

- `ended` (true/false): True once ended
- `listing` (object): The listing, if Reverb returned it
- `listing_id` (text): The listing ended
- `reason` (text): The reason given

**Example output**

```json
{
  "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 ID (`conversation_id`, text, required): The conversation's id, from 'List conversations' or a trigger.

**Outputs**

- `conversation` (object): The conversation
- `messages` (list): Its messages, oldest first

**Example output**

```json
{
  "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 ID (`listing_id`, text, required): The listing's number or Reverb link, from 'List my listings' or an earlier step.

**Outputs**

- `listing` (object): The listing
- `listing_id` (text): The listing's number
- `state` (text): Its state: draft, live, ended or sold

**Example output**

```json
{
  "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**

- `account` (object): Your account, as Reverb gives it

**Example output**

```json
{
  "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 number (`order_number`, text, required): The order's number, from 'List orders', a trigger or an earlier step.

**Outputs**

- `order` (object): The order
- `status` (text): Its status, such as paid or shipped

**Example output**

```json
{
  "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 number (`order_number`, text, required): The order's number, from 'List orders', a trigger or an earlier step.
- Rating (`rating`, text, required): How it went, out of 5. One of: `5` (5 stars), `4` (4 stars), `3` (3 stars), `2` (2 stars), `1` (1 star).
- Comment (`message`, text): What to say about the buyer.

**Outputs**

- `left` (true/false): True once left
- `order_number` (text): The order rated
- `rating` (number): The rating given
- `result` (object): What Reverb answered

**Example output**

```json
{
  "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 only (`unread_only`, true/false): Only conversations with messages you haven't read.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave. At least 1.
- Page size (`per_page`, number): How many to get per page, 1 to 100. Reverb picks if empty. From 1 to 100.

**Outputs**

- `conversations` (list): The conversations, as Reverb gives them
- `count` (number): How many are on this page
- `next_page` (number): The next page's number, or 0 when this is the last
- `page` (number): The page number given
- `total` (number): How many there are in all
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "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 feedback (`direction`, text): Feedback you received, or feedback you sent. One of: `received` (Received (default)), `sent`. Default: `received`.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave. At least 1.
- Page size (`per_page`, number): How many to get per page, 1 to 100. Reverb picks if empty. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `feedback` (list): The feedback, as Reverb gives it
- `next_page` (number): The next page's number, or 0 when this is the last
- `page` (number): The page number given
- `total` (number): How many there are in all
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "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 listings (`state`, text): 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`.
- SKU (`sku`, text): Only the listing with this SKU.
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave. At least 1.
- Page size (`per_page`, number): How many to get per page, 1 to 100. Reverb picks if empty. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `listings` (list): The listings
- `next_page` (number): The next page's number, or 0 when this is the last
- `page` (number): The page number given
- `total` (number): How many there are in all
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "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**

- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave. At least 1.
- Page size (`per_page`, number): How many to get per page, 1 to 100. Reverb picks if empty. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `negotiations` (list): The offers, as Reverb gives them
- `next_page` (number): The next page's number, or 0 when this is the last
- `page` (number): The page number given
- `total` (number): How many there are in all
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "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 orders (`group`, text): All orders, those to ship, or those not paid yet. One of: `all` (All orders (default)), `awaiting_shipment` (Awaiting shipment), `unpaid`. Default: `all`.
- Updated after (`updated_after`, date and time): Only orders changed after this time (all orders only).
- Updated before (`updated_before`, date and time): Only orders changed before this time (all orders only).
- Page (`page`, number): Which page to get, from 1. Use the 'next_page' an earlier run gave. At least 1.
- Page size (`per_page`, number): How many to get per page, 1 to 100. Reverb picks if empty. From 1 to 100.

**Outputs**

- `count` (number): How many are on this page
- `next_page` (number): The next page's number, or 0 when this is the last
- `orders` (list): The orders
- `page` (number): The page number given
- `total` (number): How many there are in all
- `total_pages` (number): How many pages there are

**Example output**

```json
{
  "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 number (`order_number`, text, required): The order's number, from 'List orders', a trigger or an earlier step.

**Outputs**

- `order_number` (text): The order marked
- `picked_up` (true/false): True once marked
- `result` (object): What Reverb answered

**Example output**

```json
{
  "order_number": "20",
  "picked_up": true,
  "result": {}
}
```

### Mark order shipped

Mark an order shipped with its carrier and tracking number.

**Inputs**

- Order number (`order_number`, text, required): The order's number, from 'List orders', a trigger or an earlier step.
- Carrier (`shipping_provider`, text, required): Who is delivering it, such as USPS.
- Tracking number (`tracking_number`, text, required): The carrier's tracking number.
- Email the buyer (`send_notification`, true/false): Send the buyer Reverb's shipped email.

**Outputs**

- `order_number` (text): The order marked
- `result` (object): What Reverb answered
- `shipped` (true/false): True once marked

**Example output**

```json
{
  "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 ID (`listing_id`, text, required): The listing's number or Reverb link, from 'List my listings' or an earlier step.

**Outputs**

- `listing` (object): The listing
- `listing_id` (text): The listing's number
- `state` (text): Its state: draft, live, ended or sold

**Example output**

```json
{
  "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 ID (`conversation_id`, text, required): The conversation's id, from 'List conversations' or a trigger.
- Message (`message`, text, required): What to say.

**Outputs**

- `conversation_id` (text): The conversation replied in
- `result` (object): What Reverb answered
- `sent` (true/false): True once sent

**Example output**

```json
{
  "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 ID (`listing_id`, text, required): The listing's number or Reverb link, from 'List my listings' or an earlier step.
- Make (`make`, text): The brand, such as Fender. Leave empty to keep it.
- Model (`model`, text): The model, such as Stratocaster. Leave empty to keep it.
- Title (`title`, text): The listing's title. Reverb makes one from the make and model if empty. Leave empty to keep it.
- Category (`category_uuid`, text): Where buyers find it on Reverb. Leave empty to keep it.
- Condition (`condition_uuid`, text): Its condition. B-Stock and Mint (with inventory) need your account to allow them. Leave empty to keep it.
- Price (`price`, number): The asking price, such as 499.99. Leave empty to keep it. At least 0.
- Currency (`currency`, text): The currency of the price, such as USD. Your shop's currency if empty.
- Description (`description`, text): What buyers read about it. Leave empty to keep it.
- SKU (`sku`, text): Your own stock code for it. Leave empty to keep it.
- Year (`year`, text): When it was made: 1959, 1980s or mid 70s. Leave empty to keep it.
- Finish (`finish`, text): Its colour or finish, such as Sunburst. Leave empty to keep it.
- UPC or EAN (`upc`, text): The barcode number, for new items. Leave empty to keep it.
- Photo addresses (`photos`, list): Web addresses of photos to add, each starting https://. On an update they are added to the listing's photos.
- Quantity (`inventory`, number): 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 offers (`offers_enabled`, true/false): Whether buyers can make offers. Leave empty to keep it.
- Shipping profile (`shipping_profile_id`, text): One of the shipping profiles set up in your shop on Reverb. Leave empty to keep it.

**Outputs**

- `listing` (object): The listing
- `listing_id` (text): The listing's number
- `state` (text): Its state: draft, live, ended or sold

**Example output**

```json
{
  "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"
}
```
