# Update Bandcamp merch stock after a show

> Merch table sales taken off your Bandcamp stock per size, color and shipping origin, re-read just before saving so online orders are not lost.

Source: https://cotlet.dev/integrations/bandcamp-api-mcp-server/update-merch-stock

The merch box went on tour, the table sold records and shirts every night, and Bandcamp still shows the old counts. Fans online can buy a size you no longer have.

Cotlet does it in your own Bandcamp account with list\_merch\_items and update\_merch\_quantity, called by your AI agent, an n8n workflow or a script.

[Request access](https://cotlet.dev/app/signup?app=bandcamp) [All Bandcamp tools](https://cotlet.dev/integrations/bandcamp-api-mcp-server)

Hosted · nothing to install or maintain

Official options

## Can Bandcamp do this on its own?

Bandcamp's Merch Orders API has update\_quantities, for labels and fulfillment partners that Bandcamp approves (checked 12 Oct 2026). Bandcamp Sync for Shopify, a beta for Pro and Label accounts, keeps stock in step with a Shopify store by matching SKUs. Neither covers cash sales at a merch table for an artist without Shopify, so those counts are edited item by item.

By hand

## How you do it in Bandcamp today

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.

With an agent

## How to update Bandcamp merch stock after a show

Prompt

```
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.

### What you get back

Example data

```
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).
```

### Other ways to ask

- Set the Band Tote to 40 at my home origin; the reprint just arrived.
- Every morning on tour, ask me what sold last night and update Bandcamp, then list anything under 5.
- Mark every option of the 2024 tour shirt Sold Out; we are not reprinting it.

Before you automate it

## What Bandcamp allows, and what to know first

- 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?](https://get.bandcamp.help/en/articles/15263170-how-do-i-sell-merch-on-bandcamp) · [Bandcamp Help: Can I ship from multiple locations?](https://get.bandcamp.help/en/articles/15263247-can-i-ship-from-multiple-locations) · [Bandcamp Help: How Bandcamp Sync for Shopify works](https://get.bandcamp.help/en/articles/15263055-how-bandcamp-sync-for-shopify-works) · [Bandcamp Merch Orders API](https://bandcamp.com/developer/merch)

REST

## Call update\_merch\_quantity from a script

curl

```
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"}'
```

Example response

```
{
"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.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/bandcamp-api-mcp-server#automations)

Tools

## Bandcamp tools this automation uses

__Cotlet Bandcamp tools used to update Bandcamp merch stock after a show__
| Tool | Parameters |
| ----------------------- | ----------------------------------------------- |
| list\_merch\_items | low\_stock\_below |
| update\_merch\_quantity | item\_id, quantity\_available, shipping\_origin |

[All 13 Bandcamp tools with descriptions](https://cotlet.dev/integrations/bandcamp-api-mcp-server#tools)

## More Bandcamp automations

- [Mark Bandcamp merch orders as shipped with tracking](https://cotlet.dev/integrations/bandcamp-api-mcp-server/mark-merch-orders-shipped)
- [Get a monthly Bandcamp sales report per release](https://cotlet.dev/integrations/bandcamp-api-mcp-server/sales-report-per-release)
- [Run a Bandcamp sale with a discount code and tell your followers](https://cotlet.dev/integrations/bandcamp-api-mcp-server/create-discount-code-and-announce)
- [Bandcamp API and MCP server: every tool](https://cotlet.dev/integrations/bandcamp-api-mcp-server)
- [All use cases](https://cotlet.dev/use-cases)

## Give your agent access to Bandcamp.

Free 7-day trial with 5,000 credits, no card needed. Cotlet is independent and not affiliated with Bandcamp.

[Request access](https://cotlet.dev/app/signup?app=bandcamp)