The Velveteen Developer API
Updated June 13, 2026
The Velveteen developer API lets you build on your catalog programmatically. You create an API key, authenticate with a Bearer token, and call endpoints for releases, artists, tracks, labels, people, publishing houses, pitches, and royalties. The API is available on the Pro and Label plans.
This section covers creating API keys, authenticating, the scopes that control access, and the endpoints the API exposes. The full reference lives in the Developer area of the dashboard.
What you can do
Manage catalog
Read and write releases, tracks, artists, labels, people, and publishing houses.
Work with pitches
Read, create, update, and withdraw pitches.
Read royalties
Read balances and earnings, and request payouts.
Scoped keys
Each key carries scopes that limit what it can do.
Getting started
- 1
Open Developer
Go to the Developer area in the dashboard, on the Pro or Label plan. - 2
Create an API key
Name a key, choose its scopes, and copy it once at creation. - 3
Call the API
Send requests to the API base URL with your key in the Authorization header.
Tip
Frequently asked questions
Which plans include the API?+
The developer API is available on the Pro and Label plans.
How do I authenticate?+
Send your API key as a Bearer token in the Authorization header. See Authentication for the base URL.
Where are the full docs?+
In the Developer area of the dashboard, under the Documentation tab.
What can the API touch?+
Your catalog, pitches, and royalties, limited by the scopes on the key you use.
Related articles
API keys
Create a key with a name and scopes, copy it once at creation, revoke it anytime, and the limit of ten active keys per account.
Authentication
The base URL, the Authorization Bearer header with your key, and where to find the in-app reference and code examples.
Scopes
The six scopes, catalog, pitches, and royalties in read and write form, and how they limit what a key can do.
Endpoints
The resource groups the API covers, how pagination works, and the standard error codes the API returns.