Skip to main content
POST
/
suno
/
v2
/
playlist
/
create
create inspiration playlist
curl --request POST \
  --url https://api.mountsea.ai/suno/v2/playlist/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clip_ids": [
    "30c08405-8be7-4bbf-9b50-f72250fd1531",
    "93d2bfe9-c6d4-42cd-88fc-ee508d4fa6ed"
  ],
  "name": "My Inspiration Set"
}
'
{
  "playlist_id": "119573ff-8e48-4fe6-9029-39c76c9a5597"
}
Creates a Suno playlist and adds 1–4 inspiration clips atomically on one account. The account binding is stored so a later task=inspiration generate call uses the same account automatically.
Synchronous — returns playlist_id in the response body (HTTP 200/201). No task polling required.
All clip_ids must belong to the same Suno account. This is the account anchor for the whole Inspiration workflow.
This is Step 1 of the Inspiration workflow. Next: Generate with task=inspiration and playlist_id.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
clip_ids
string[]
required

Inspiration clip IDs (1–4). All must belong to the same Suno account. Used as account anchor: the playlist will be created on the account that owns these clips, and all clips will be added to the playlist atomically.

Required array length: 1 - 4 elements
Example:
[
  "30c08405-8be7-4bbf-9b50-f72250fd1531",
  "93d2bfe9-c6d4-42cd-88fc-ee508d4fa6ed"
]
​
name
string
default:Untitled

Playlist display name. Defaults to "Untitled".

Example:

"My Inspiration Set"

Response

​
playlist_id
string
required

Suno playlist ID. Pass this to /generate as playlist_id when using task=inspiration.

Example:

"119573ff-8e48-4fe6-9029-39c76c9a5597"