Skip to main content
POST
/
artist
/
Create Artist
curl --request POST \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/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
    }
  ]
}'
{
  "message": "artist created successfully",
  "artist": {
    "id": "2fca1b81-2f97-4b02-92a2-899d17c756b8",
    "artistName": "testArtist",
    "signDate": "2022-01-21T00:00:00.000Z",
    "label": "Mavins Records",
    "externalId": "1rema45",
    "TenantId": 2,
    "createdAt": "2024-12-12T10:30:00.000Z",
    "updatedAt": "2024-12-12T10:30:00.000Z"
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Code Examples

const response = await fetch('https://server26-dot-royalti-project.uc.r.appspot.com/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

​
message
string
​
artist
object