Update Bandcamp merch stock after a show

1. Open your Bandcamp merch page, click the item and go to the Quantities section of the merch editor.
2. Find the right shipping origin and option (each size or color has its own count) and type the new number; 0 marks it Sold Out and an empty field means unlimited.
3. Save, then repeat for every item and option you sold at the show.
4. Work out each new number by hand from the old one, while Bandcamp keeps lowering the same counts as online orders come in. A typo or a stale number from this morning oversells a shirt that is already gone.

We sold 9 black Night Drive LPs, 4 red ones and 11 tour tees (3 S, 5 M, 3 L) at the merch table last night. Take them off my Bandcamp stock and tell me what is low.

1. 01

   Subtract, never overwrite

   You give the agent what sold, not the new totals. It maps each line to an item and option from list_merch_items by title, color and size, and works out the new count from the live number.

2. 02

   Pick the origin that holds the tour stock

   With more than one shipping origin, the agent asks once which origin the tour box belongs to and uses it for every line, leaving your home or distributor stock alone.

3. 03

   Re-read right before writing

   Online orders keep lowering the same counts, so the agent reads the item again immediately before update_merch_quantity. If the number moved since your message, it subtracts from the new figure.

4. 04

   Stop at zero and unclear lines

   A result below zero is set to 0 (Sold Out) and reported, since Bandcamp may already have sold the last copy online. A line it cannot map, such as "hoodies" when two hoodie items exist, is asked about, not guessed.

5. 05

   Flag what runs low

   After the update it lists options under your threshold per origin, so you know which size to reprint before the next city.

Tour origin updated.
Night Drive LP Black: 15 to 6. Red: 9 to 5.
Tour Tee S: 6 to 3. M: 7 to 2. L: 3 to 0 (now Sold Out).
Re-read before saving: Tour Tee M had dropped from 8 to 7 by an online order, so it was used.
Low (under 5): Tour Tee S and M, Band Tote (4 at the home origin).

• Bandcamp lowers the quantity on its own when an item sells on Bandcamp, so only sales made elsewhere, like at shows or on another site, need a manual edit.
• Bandcamp keeps a separate inventory for each shipping origin and routes each order to the origin with the cheapest rate for the buyer that has stock.
• In the Bandcamp merch editor, a quantity of 0 marks the item Sold Out and an empty quantity means unlimited.
• Bandcamp Sync for Shopify treats Shopify as the source of truth, needs an identical SKU on every Bandcamp option, and links one Bandcamp account to one Shopify store.
• Bandcamp's own update_quantities API call asks for the current quantity_sold to guard against a sale landing during the update.

update_merch_quantity changes only your own Bandcamp data and reach no one else, so it runs without asking first.

Sources: Bandcamp Help: How do I sell merch on Bandcamp? · Bandcamp Help: Can I ship from multiple locations? · Bandcamp Help: How Bandcamp Sync for Shopify works · Bandcamp Merch Orders API

curl https://cotlet.dev/api/v1/bandcamp/update_merch_quantity \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"item_id":"o_1842702675","quantity_available":6,"shipping_origin":"Tour van"}'

{
  "item_id": "p_1154611570",
  "title": "Band Tote",
  "quantity_available": 40,
  "previous_quantity_available": 6
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the tool is bandcamp_update_merch_quantity. Example data.

• Mark Bandcamp merch orders as shipped with tracking
• Get a monthly Bandcamp sales report per release
• Run a Bandcamp sale with a discount code and tell your followers
• Bandcamp API and MCP server: every tool
• All use cases