Developer Help Center

Artist Object

Parameter

Type

Description

name

Optional

string

Name of the artist.

  • When provided without an artistId, tries to find an existing artist with the same name (ASCII SQL). If no such artist is found, creates a new artist.

  • When provided with an artistId, updates the name of the artist.

  • Either an artistName or artistId must be provided. If neither are provided, the artist will be null and the metadata for the track will be invalid.

  • All artists in child enterprises automatically appear as Rights Holders in the parent enterprise.

artistId

Optional

integer

ID for an existing artist.

  • Either an artistName or artistId must be provided. If neither are provided, the artist will be null and the metadata for the track will be invalid.

artistExternalIds

Optional*

array of objects

External IDs for the artist.

*Mandatory for all artists, except for contributors with roles other than Primary Artist, Featuring, or Remixer. For all artists where this parameter is mandatory, this array must include an object for every supported store.

  • These IDs are used by the stores to make sure that all of an artist's content stays together. For artists who have not yet distributed to a specific store, we will generate a new ID if/when a release for the artist is distributed to the store.

  • Each object in the array represents an external ID for the artist at a specific store.

Parameter

Type

Description

profileID

Mandatory

integer

One of the following:

  • For an artist already on the store, external ID for the artist at the specified store.

    To find this ID go to the artist's page at the store, and copy-paste the numeric part of the URL

  • For artists not already on the store, 0.

    This indicates we should generate an ID for the artist if/when a release for the artist is distributed to the store.

    This indicates we should generate an ID for the artist. The second time you distribute a release for a new artist, you must retrieve the artist ID and provide it in the release. See Managing External Artist IDs.

distributorStoreId

Mandatory

integer

Revelator ID for the store.

Currently supported for:

  • Apple Music - 1

  • Spotify - 9