API Overview

The LabelGrid public API lets developers integrate with LabelGrid programmatically — read your catalogue, create and update releases, upload assets, and submit releases for distribution.

What the API offers

The public API is mounted under /api/public/... on api.labelgrid.com and provides programmatic access to:

• Releases — list, create, update, delete; upload artwork; validate; submit for distribution
• Tracks — list, create, update; upload audio files; manage track licenses
• Labels — list and manage your label profiles
• Artists — list and manage artist profiles
• Writers and Contributors — list and manage writer/contributor profiles
• Publishers — list and manage publisher profiles
• Webhooks — register webhook endpoints for asynchronous notifications
• Reference data — genres, languages, contributor roles, instruments, distribution territories, distro outlets

Common use cases

• Automate release creation from your existing systems
• Sync catalogue data with your database
• Build custom dashboards and reporting tools
• Integrate with your existing workflow tools
• Power white-label distribution services on top of LabelGrid

---

Getting API access

To use the LabelGrid API, you need:

1. A LabelGrid account with API access enabled on the plan
2. An API token generated from your account settings: open the avatar menu in the top-right and click API Tokens (only visible if API access is enabled)
3. (Optional) IP whitelisting for additional security — configure under the same area

If you do not see the API Tokens option in your account, contact support to discuss enabling API access on your plan.

---

Authentication

All API requests must include a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

---

API Documentation

For complete endpoint reference, request/response schemas, and live “try it” tooling, see the auto-generated documentation:

• Production: https://api.labelgrid.com/docs/api
• Sandbox: https://api-sandbox.stg.labelgrid.com/docs/api

The documentation includes:

• Authentication guide
• Every available endpoint with request and response examples
• Rate-limiting information
• Webhook configuration

---

Sandbox

LabelGrid offers a sandbox environment so you can build and test against the API without affecting your production catalogue. Sandbox accounts are provisioned on request — contact support to set one up.

---

Webhooks

The public API supports webhooks for asynchronous event notification (review status changes, delivery updates, etc.). See Webhooks for setup and the available event types.

---

Need Help?

If you need API assistance, contact our support team with technical details about your integration.