Discogs (Personal Access Token) - Nango Docs

🚀 Quickstart

Connect to Discogs with a personal access token through Nango and see data flow in 2 minutes.

1

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Discogs (Personal Access Token).

2

Authorize Discogs

Go to Connections -> Add Test Connection -> Discogs (Personal Access Token) -> enter your personal access token and click Authorize. See the connect guide for how to generate a token.

3

Call the Discogs API

Let’s make your first request to the Discogs API (fetch the authenticated user’s identity). Replace the placeholders below with your Environment API key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/oauth/identity" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.get({
    endpoint: '/oauth/identity',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

4

Implement Nango in your app

Follow our quickstart to integrate Nango in your app.To let your users connect their own accounts, follow the connect guide linked below.

📚 Discogs (Personal Access Token) integration guides

Nango maintained guides for common use cases.

How do I link my Discogs account? Generate a Discogs personal access token and connect it to Nango.

Official docs: Discogs API documentation

API gotchas

Discogs requires a unique User-Agent header on every API request. Nango sets one automatically for proxy requests.
Personal access tokens are sent as Authorization: Discogs token=<token>.
Personal access tokens are tied to a single Discogs user account and are best suited for scripts or single-user integrations. For multi-user integrations, use Discogs OAuth instead.
Discogs rate limits authenticated requests to 60 per minute per user. Check the X-Discogs-Ratelimit-Remaining response header.

🧩 Pre-built syncs & actions for Discogs (Personal Access Token)

Enable them in your dashboard. Extend and customize to fit your needs.

Collection

Function name	Description	Type	Source code
`add-to-collection`	Add a release to a collection folder.	Action	🔗 Github
`create-collection-folder`	Create a collection folder.	Action	🔗 Github
`delete-collection-folder`	Delete a collection folder.	Action	🔗 Github
`get-collection-value`	Get the minimum, median, and maximum value of a collection.	Action	🔗 Github
`remove-from-collection`	Remove a release instance from a collection folder.	Action	🔗 Github
`update-collection-folder`	Update a collection folder name.	Action	🔗 Github
`collection`	Sync collection folders and releases for the authenticated user.	Sync	🔗 Github
`collection`	Sync collection folders and releases for the authenticated user.	Sync	🔗 Github

Contributions

Function name	Description	Type	Source code
`contributions`	Sync release contributions for the authenticated user.	Sync	🔗 Github

Database

Function name	Description	Type	Source code
`get-artist`	Get an artist by ID.	Action	🔗 Github
`get-label`	Get a label by ID.	Action	🔗 Github
`get-master`	Get a master release by ID.	Action	🔗 Github
`get-release`	Get a release by ID.	Action	🔗 Github
`search`	Search the Discogs database.	Action	🔗 Github

Inventory

Function name	Description	Type	Source code
`inventory`	Sync marketplace inventory listings for the authenticated user.	Sync	🔗 Github

Lists

Function name	Description	Type	Source code
`lists`	Sync user lists and their items.	Sync	🔗 Github
`lists`	Sync user lists and their items.	Sync	🔗 Github

Marketplace

Function name	Description	Type	Source code
`add-order-message`	Add a message to a marketplace order.	Action	🔗 Github
`create-listing`	Create a new marketplace listing.	Action	🔗 Github
`delete-listing`	Delete a marketplace listing.	Action	🔗 Github
`export-inventory`	Request an inventory export for the authenticated user.	Action	🔗 Github
`get-fee`	Calculate the marketplace fee for a listing price.	Action	🔗 Github
`get-inventory-export`	Get a specific inventory export by ID.	Action	🔗 Github
`get-inventory-exports`	List inventory exports for the authenticated user.	Action	🔗 Github
`get-listing`	Get a marketplace listing by ID.	Action	🔗 Github
`get-order-messages`	Get messages for a marketplace order.	Action	🔗 Github
`get-order`	Get a marketplace order by ID.	Action	🔗 Github
`get-price-suggestions`	Get marketplace price suggestions for a release.	Action	🔗 Github
`update-listing`	Update a marketplace listing.	Action	🔗 Github
`update-order-status`	Update the status of a marketplace order.	Action	🔗 Github

Orders

Function name	Description	Type	Source code
`orders`	Sync marketplace orders for the authenticated user.	Sync	🔗 Github

Profile

Function name	Description	Type	Source code
`profile`	Sync the authenticated Discogs user profile.	Sync	🔗 Github

Submissions

Function name	Description	Type	Source code
`submissions`	Sync release submissions for the authenticated user.	Sync	🔗 Github

Wantlist

Function name	Description	Type	Source code
`add-to-wantlist`	Add a release to the wantlist.	Action	🔗 Github
`remove-from-wantlist`	Remove a release from the wantlist.	Action	🔗 Github
`wantlist`	Sync the authenticated user wantlist.	Sync	🔗 Github