Developer Help Center

Managing External Artist IDs

Some DSPs share their artist IDs with us, allowing us to tightly couple our artists with theirs. This enables us to avoid situations where two different artists with the same name are merged or a single artist's catalog is split between two or more profiles.

If an artist is already on the DSP, we require you to provide this ID when creating releases for the artist. If an artist is not already on the DSP, we require you to indicate that we should generate an ID for the artist when (if ever) the artist is distributed to the DSP.


  • Currently, this is supported for Apple Music and Spotify, only.

  • These IDs must be provided when creating releases, even if you are not sending releases to DSPs via the Revelator system. In this case, the IDs can be assigned the value "0" and will remain with this value.

Distributing additional releases for artists with new IDs

You must retrieve newly generated IDs immediately before distributing additional releases for an artist.


If the ID for the artist has already been generated, but you continue to indicate that a new ID should be generated, you will delete the ID from the Revelator system and may cause a second ID to be generated for the artist!

  1. Specify the Revelator artistId parameter in the new release to ensure that the same Revelator artist is being assigned.

  2. Immediately before distributing the new release, retrieve the ID with the GET /content/artist/all or GET /content/artist/{Id} endpoint. The response will include the profileId for each DSP. See Artist Object.

    • If the value of the profileId is still 0, the ID for the artist has not yet been generated.

    • If the value of the profileId is >0, this is the generated ID.


    Do not continuously poll our system for the ID. Only run the GET request immediately before distributing a new release which requires the ID. There are many reasons that an ID may never be generated (for example, when a Spotify release does not ultimately go live).


    Different DSPs generate new IDs at different times in the distribution process:

    • For Apple Music, this ID is generated immediately upon distributing the original release. Therefore, as soon as the original release is distributed, the apple ID will be available.

    • For Spotify, this ID is generated when the original release goes live. When relevant, Spotify uses our internal ID to ensure the artist is merged with the correct profile.

  3. Specify the current values for the external IDs in the release metadata.

    If the ID is still 0, the correct ID will be assigned to the artist (and on all releases for the artist) as soon as it is available.

  4. Distribute the new release.