Skip to main content
POST
cURL

Body

application/json

Artist creation parameters

name
string
required

The name of the artist to create

Minimum string length: 1
spotify_artist_id
string

Optional Spotify artist id. When provided, the endpoint resolves-or-creates the canonical artist for that id: if an artist already carries it, that artist is linked to the account and returned (200) instead of creating a duplicate; otherwise the artist is created with its Spotify profile attached (201).

account_id
string<uuid>

UUID of the account to create the artist for. Only applicable when the authenticated account has access to multiple accounts via organization membership. If not provided, the artist is created for the API key's own account.

organization_id
string<uuid>

Optional organization ID to link the new artist to

Response

Existing canonical artist for the given spotify_artist_id linked to the account (no new artist created)

artist
object
required