Skip to main content
POST
/
artist
Create Artist
curl --request POST \
  --url https://api.royalti.io/artist/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "artistName": "testArtist",
  "signDate": "2022-01-21",
  "externalId": "1rema45",
  "label": "Mavins Records",
  "copyright": "mavins global jonzing world",
  "publisher": "mavings global",
  "contributors": [
    {
      "name": "contributor 1",
      "role": "composer"
    },
    {
      "name": "contributor 2",
      "role": "producer"
    }
  ],
  "links": {
    "website": "https://remamavins.com/",
    "twitter": "https://twitter.com/taremamavins",
    "instagram": "https://www.instagram.com/remamavins/",
    "facebook": "https://www.facebook.com/remamavins",
    "youtube": "https://www.youtube.com/remamavins"
  },
  "users": [
    "91f1d1bd-ef25-4990-bd4f-aeee696c73a9",
    "9ea08acc-e135-4bd9-b159-48339ff65061",
    "b369dabe-b4e0-4787-91a5-b561c98601e5"
  ],
  "split": [
    {
      "user": "91f1d1bd-ef25-4990-bd4f-aeee696c73a9",
      "share": 30
    },
    {
      "user": "9ea08acc-e135-4bd9-b159-48339ff65061",
      "share": 50
    },
    {
      "user": "b369dabe-b4e0-4787-91a5-b561c98601e5",
      "share": 20
    }
  ]
}
'
{
  "id": "2fca1b81-2f97-4b02-92a2-899d17c756b8",
  "artistName": "alobammm",
  "signDate": "2025-01-12T00:00:00.000Z",
  "label": "Mavins Records",
  "externalId": "1rema45",
  "copyright": "mavins global jonzing world",
  "publisher": "mavings global",
  "links": {
    "website": "https://remamavins.com/",
    "twitter": "https://twitter.com/taremamavins",
    "instagram": "https://www.instagram.com/remamavins/",
    "facebook": "https://www.facebook.com/remamavins",
    "youtube": "https://www.youtube.com/remamavins"
  },
  "contributors": [
    {
      "name": "contributor 1",
      "role": "composer"
    },
    {
      "name": "contributor 2",
      "role": "producer"
    }
  ],
  "TenantId": 2,
  "createdAt": "2025-01-21T14:30:00.000Z",
  "updatedAt": "2025-01-21T14:30:00.000Z"
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

artist/ Description:
The /artist/ endpoint allows the creation of a new artist profile by providing details such as artist name, sign date, label, external ID, links, associated users, and their respective split shares. Method:
POST Request Payload:
ParameterTypeDescriptionRequired
artistNamestringThe name of the artist.Yes
signDatedateThe date the artist was signed.Yes
labelstringThe label associated with the artist.No
copyrightstringThe copyright information of the artist.No
publisherstringThe publisher information of the artist.No
contributorsarrayAn array of objects containing contributor names and roles.Yes
externalIdstringThe external ID of the artist.Yes
linksobjectLinks to the artist’s website and social media profiles.Yes
usersarrayAn array of user IDs associated with the artist.Yes
splitarrayAn array of objects containing user IDs and their respective shares.Yes
See sample payload and response below

​
Code Examples

const response = await fetch('https://api.royalti.io/artist/', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "artistName": "sample-artistName",
    "signDate": "2024-01-21",
    "externalId": "sample-externalId",
    "label": "sample-label",
    "copyright": "sample-copyright",
    "publisher": "sample-publisher",
    "contributors": [
      {
        "name": "sample-name",
        "role": "sample-role"
      }
    ],
    "links": {
      "website": "sample-website",
      "twitter": "sample-twitter",
      "instagram": "sample-instagram",
      "facebook": "sample-facebook",
      "youtube": "sample-youtube"
    },
    "users": [
      {}
    ],
    "split": [
      {
        "user": "sample-user",
        "share": 1
      }
    ]
  })
});

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
​
artistName
string
required

The name of the artist

​
signDate
string<date>
required

The date the artist was signed

​
users
string[]
required

An array of user IDs associated with the artist

​
split
object[]
required

An array of objects containing user IDs and their respective shares

​
externalId
string

The external ID of the artist

​
label
string

The label associated with the artist

​
copyright
string

Copyright information

​
publisher
string

Publisher information

​
contributors
object[]

Contributors to the artist

​
links
object

Links to the artist's website and social media profiles

Response

Success

​
id
string<uuid>

Unique identifier of the artist

​
artistName
string

Name of the artist

​
signDate
string<date-time>

Date the artist was signed

​
label
string

Label associated with the artist

​
externalId
string

External ID of the artist

​
copyright
string

Copyright information

​
publisher
string

Publisher information

​
links
object

Social media and website links

​
contributors
object[]

Contributors to the artist

​
TenantId
integer

Tenant ID the artist belongs to

​
createdAt
string<date-time>

Timestamp of when the artist was created

​
updatedAt
string<date-time>

Timestamp of when the artist was last updated