Create Link

Fields

• $artist_id (String, required): The ID of the artist.

• $domain (String, required): The domain of the link.

• $path (String, required): The path of the link.

• $type (String, required): The type of the link. The value can be bio, release or playlist

• $spotify_link (String, required): The Spotify link associated with the link.

• $title (String): The title of the link. Default to the Spotify release title

• $subtitle (String): The subtitle of the link. Defaults to Spotify artist name

• $description (String): The description of the link. Defaults to Spotify description

• $image (String): The preview image. Defaults to cover image from Spotify

• $theme (String): The theme of the link. Defaults to light.

• $fill_dsps (Boolean): Boolean indicating whether to auto-fill available DSP links (Apple Music, Amazon Music, iTunes, Deezer). Defaults to true.

• $display_artist_socials (Boolean): Boolean indicating whether to display artist socials. Defaults to true.

• $preview_type (String): The type of preview. The value can be image or spotify. Defaults to image.

• $autoplay_track (String): The Spotify ID of the song that gets autoplayed.

Request

mutation CreateLink(
    $artist_id: String!
    $domain: String!
    $path: String!
    $type: String!
    $spotify_link: String!
    $title: String
    $subtitle: String
    $description: String
    $image: String
    $theme: String
    $fill_dsps: Boolean
    $display_artist_socials: Boolean
    $preview_type: String
  ) {
    create_link(
      artist_id: $artist_id
      domain: $domain
      path: $path
      type: $type
      spotify_link: $spotify_link
      title: $title
      subtitle: $subtitle
      description: $description
      image: $image
      theme: $theme
      fill_dsps: $fill_dsps
      display_artist_socials: $display_artist_socials
      preview_type: $preview_type
    ) {
      success
      link {
        id
        domain
        path
        artist_id
        type
        title
        subtitle
        description
        image
        theme
        display_artist_socials
        release_name
        preview_type
        layout
        destinations {
          id
          type
          url
          cta
          text
          logo
          enabled
          deeplink_ios
          deeplink_android
          priority
        }
        tracks {
          id
          url
          name
          priority
        }
      }
    }
  }