Create artist

API Endpoint

POST /artist
Host: api.audicient.com
Authorization: <API_KEY>:<API_SECRET>
enterprise-id: 100001

Authentication Requirements

All requests must include authentication credentials.

• Authorization Header: Pass the API key and secret as <API_KEY>:<API_SECRET>.

• Enterprise-ID Header: Required when creating an artist at the account level.

Request Body

Parameter	Type	Description
name	string	Name of the artist (minimum 2 characters).
description	string	Description of the artist (optional).
imageId	string	UUID of the image (nullable).
spotifyId	string	Spotify artist ID (validated format, nullable).
appleId	string	Apple Music artist ID (validated format, nullable).

Example Request

{
  "name": "Example Artist",
  "description": "A sample artist description.",
  "imageId": "550e8400-e29b-41d4-a716-446655440000",
  "spotifyId": "6vWDO969PvNqNYHIOW5v0m",
  "appleId": "909253"
}

Success Response

{
  "status": 201,
  "success": true,
  "message": "Artist has been created successfully",
  "data": {
    "artistId": 123456,
    "enterpriseId": 987654,
    "tenantId": "abcd1234-ef56-7890-gh12-ijkl34567890",
    "name": "Example Artist",
    "description": "A sample artist description.",
    "imageId": "550e8400-e29b-41d4-a716-446655440000",
    "spotifyId": "6vWDO969PvNqNYHIOW5v0m",
    "appleId": "909253",
    "createdAt": "2025-03-16T14:03:23.427Z",
    "updatedAt": "2025-03-16T14:03:23.427Z"
  }
}