Create a self-serve soundlink
Creates a self-serve soundlink in the organization. This is the Public
API equivalent of the in-app create flow. It does not create a wallet
campaign and does not appear on GET /v1/campaigns.
Requires the soundlinks:write scope.
Idempotency-Key is required. Reusing the key with an unchanged
body replays the original 201; a different body returns
409 idempotency_key_conflict. Keys are honored for 24 hours.
Auth: Accepts API key or OAuth Bearer (soundlinks:write).
Authorizations
Pass your Soundlink sk_* API key as a Bearer token:
Authorization: Bearer sk_<prefix>_<token> (not an OAuth token; see
oauthBearer for that). Accepted on all Public API operations. Send
only one Authorization header per request.
Headers
A unique string identifying this request, used to safely retry write
operations (campaign create/stop/budget, soundlink create) without repeating
side effects. Required on every request that references this parameter.
Reusing this key with an unchanged request body replays the original
response; reusing it with a different body returns
409 idempotency_key_conflict. Keys are honored for 24 hours.
1 - 255Body
Human-readable soundlink name.
1HTTPS Spotify track or playlist URL. Album, artist, and URI
(spotify:track:...) forms are rejected. An optional intl-xx
path segment is accepted. Query strings are stripped before
lookup. The resource must currently exist on Spotify.
"https://open.spotify.com/track/11dFghVXANMlKmJXsNCbNl"
When true, fans who connect Spotify from the landing page are
asked to follow the track artist (artistIdFollow, or the
track's primary artist when omitted), or the playlist itself
when spotifyUrl is a playlist. Defaults to false.
Spotify artist ID used for auto-follow on track links.
Optional. Persisted even when autoFollow is false. For
multi-artist tracks, pass the artist that should be followed.
Ignored when spotifyUrl is a playlist.
Meta pixel ID. Must be sent together with
metaConversionAccessToken. Omit both to skip Meta tracking.
Meta Conversions API access token. Write-only: accepted on create,
never returned on GET. Must be sent together with metaPixelId.