Skip to main content
POST
create inspiration playlist
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:
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"