Skip to main content
POST
/
labels
/
Create Label
curl --request POST \
  --url https://api.royalti.io/labels/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Future Sound Records",
  "website": "https://futuresound.example.com",
  "country": "US",
  "labelCode": "LC12345",
  "dpid": "DPID-123456",
  "contacts": {
    "email": "contact@futuresound.example.com"
  },
  "socialLinks": {
    "twitter": "https://twitter.com/futuresound"
  }
}
'
{
  "status": "success",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "TenantId": 123,
    "name": "<string>",
    "logo": "<string>",
    "website": "<string>",
    "country": "US",
    "foundedDate": "2023-12-25",
    "labelCode": "<string>",
    "dpid": "<string>",
    "contacts": {},
    "socialLinks": {},
    "distributionSettings": {},
    "catalogSettings": {},
    "ddexSettings": {},
    "parentLabelId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "distribution": "<string>",
    "genres": [
      "<string>"
    ],
    "isActive": true,
    "metadata": {},
    "tradingName": "<string>",
    "pLinePrefix": "<string>",
    "cLinePrefix": "<string>",
    "isrcPrefix": "<string>",
    "upcPrefix": "<string>",
    "parentLabel": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "logo": "<string>"
    },
    "childLabels": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "logo": "<string>"
      }
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Code Examples

const response = await fetch('https://api.royalti.io/labels/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "sample-name",
    "logo": "sample-logo",
    "website": "sample-website",
    "country": "sample-country",
    "foundedDate": "2024-01-21",
    "labelCode": "sample-labelCode",
    "dpid": "sample-dpid",
    "contacts": {},
    "socialLinks": {},
    "distributionSettings": {},
    "catalogSettings": {},
    "parentLabelId": "sample-parentLabelId",
    "distribution": "sample-distribution",
    "genres": [
      {}
    ],
    "isActive": true,
    "metadata": {}
  })
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
​
name
string
required
​
website
string<uri>
​
country
string

ISO 3166-1 alpha-2 code

​
foundedDate
string<date>
​
labelCode
string
​
dpid
string
​
contacts
object
​
socialLinks
object
​
distributionSettings
object
​
catalogSettings
object
​
parentLabelId
string<uuid>
​
distribution
string
​
genres
string[]
​
isActive
boolean
default:true
​
metadata
object

Response

Created

​
status
string
Example:

"success"

​
data
object