Connect your Discogs seller account to EcomCentral using a Personal Access Token — no OAuth app required.
Authorization: Discogs token={your_token}.
The token is tied to your user account — it has full read/write access to your marketplace.
discogs.com/user/username)| Key | Required | Description | Example |
|---|---|---|---|
token |
Required | Personal Access Token from discogs.com/settings/developers | AbCdEfGhIjKlMnOp |
username |
Required | Your Discogs username (used for inventory endpoint) | vinyl_dave |
access_token or personal_token for the token; user for the username.
| Operation | Method | Endpoint |
|---|---|---|
| Test connection / identity | GET | /oauth/identity |
| List orders | GET | /marketplace/orders?page=P&per_page=N&status=All |
| Order detail | GET | /marketplace/orders/{id} |
| Send tracking (as message) | POST | /marketplace/orders/{id}/messages |
| Update order status | POST | /marketplace/orders/{id} |
| List inventory (For Sale) | GET | /users/{username}/inventory?page=P&per_page=N&status=For+Sale |
| Listing detail | GET | /marketplace/listings/{id} |
{ orders: [...], pagination: { items: N } } for orders
and { listings: [...], pagination: { items: N } } for inventory.
| Feature | Supported | Notes |
|---|---|---|
| View orders (paginated) | ✅ | Order ID, date, status, total (value + currency) |
| View order detail | ✅ | Buyer username, shipping address, items, message history |
| Send tracking | ✅ | Posts a marketplace message + sets status to Shipped |
| Update order status | ✅ | Full list of Discogs order statuses (New Order → Shipped → Refund Sent, etc.) |
| View inventory / listings | ✅ | Shows "For Sale" listings with release info, price, condition |
| View listing detail | ✅ | Full release metadata: artist, title, year, format, label, genre, styles |
| Update stock / quantity | ❌ | Not supported by Discogs API — each listing is 1 unit; list a new listing to add stock |
| Test connection | ✅ | Returns username and consumer name from /oauth/identity |
These are the valid statuses for the Update Status action:
| Status | Meaning |
|---|---|
| New Order | Buyer has placed the order |
| Buyer Contacted | You have reached out to the buyer |
| Invoice Sent | Invoice has been sent (for payment outside Discogs) |
| Payment Pending | Awaiting payment |
| Payment Received | Payment confirmed, preparing to ship |
| Shipped | Item dispatched — also set automatically by Send Tracking |
| Refund Sent | Refund has been issued |
| Cancelled (Non-Paying Buyer) | Buyer did not pay |
| Cancelled (Item Unavailable) | Listing was sold elsewhere or lost |
| Cancelled (Per Buyer's Request) | Buyer asked to cancel |
Condition codes appear in listing detail for both the media and sleeve:
| Grade | Full Name | Description |
|---|---|---|
| M | Mint | Perfect, never played |
| NM / M- | Near Mint | Nearly perfect, minimal signs of handling |
| VG+ | Very Good Plus | Shows some signs of play but sounds great |
| VG | Very Good | Some background noise, visible marks |
| G+ | Good Plus | Heavy wear, playable |
| G | Good | Significant damage, plays through |
| F | Fair | Very heavy damage |
| P | Poor | Barely playable, collectible only |
The Personal Access Token is invalid or has been revoked. Go to
discogs.com/settings/developers, revoke the old token, generate a new one,
and update the credentials via Rotate Keys in EcomCentral.
Only listings with status For Sale are shown. Drafts or listings in other states
are excluded. If the username is wrong, the inventory endpoint will return an empty set
without an error — double-check the username credential.
The Send Tracking action posts a marketplace message AND attempts to set the status to Shipped. If the order is already in a terminal state (e.g. Cancelled), Discogs will reject the status change. Use Update Status to correct state first.