SOsoundcloud
tracks

Creates or updates the storefront (Artist Storefront) of a track.

Changed on

Creates or updates the storefront module shown on the track page. The request replaces the whole storefront: optional fields (link_title, description, price) are cleared when omitted, so always send every value the storefront should keep. The request fails with 403 when the authenticated user does not own the track, and also when the user does not hold a creator subscription that includes external purchase options. The storefront links to an external page — no payment is processed by SoundCloud.

put/tracks/{track_urn}/storefront

Request

Path parameters

track_urnstring required

SoundCloud Track urn

Request body

titlestring required

Card title shown on the storefront module.

type'digital' | 'vinyl' | 'cd' | 'cassette' | 'apparel' | 'sample_pack' | 'subscription' | 'live_event' | 'live_stream' | 'other' required

The type of item offered.

linkstring required

External http(s) URL the storefront button opens.

link_titlestring

Label of the storefront button. Omit to clear.

descriptionstring

Description shown on the storefront module. Omit to clear.

pricestring

Display-only price text shown next to the item type. No payment is processed by SoundCloud. Omit to clear.

Example request

{
  "title": "Download now",
  "link": "https://example.com/my-track",
  "link_title": "Download",
  "description": "Get the track original files for free.",
  "price": "0"
}

Response

Success

track_urnstring

The urn of the track the storefront belongs to.

titlestring

Card title shown on the storefront module.

type'digital' | 'vinyl' | 'cd' | 'cassette' | 'apparel' | 'sample_pack' | 'subscription' | 'live_event' | 'live_stream' | 'other'

The type of item offered.

linkstring

External URL the storefront button opens.

link_titlestring nullable

Label of the storefront button.

descriptionstring nullable

Description shown on the storefront module.

image_urlstring nullable

Image shown on the storefront module. Read-only; managed on soundcloud.com.

pricestring nullable

Display-only price text shown next to the item type. No payment is processed by SoundCloud.

Example response

{
  "track_urn": "soundcloud:tracks:1495999657",
  "title": "Download now",
  "link": "https://example.com/my-track",
  "link_title": "Download",
  "price": "0"
}

Changes

  • ab7b2ffc0193Revision changes
    • breaking

      the / response's property type changed from string to object for status

    • breaking

      the / response's property type changed from string to object for status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • a163bff454e6Revision changes
    • info

      endpoint added