POST /artists

Headers

Prefer string

Preference

Values are return=representation, return=minimal, return=none, resolution=ignore-duplicates, or resolution=merge-duplicates.

Query parameters

select string

Filtering Columns

Body

artists

apple_music string(text)

Default value is empty.
artist_photos
bandcamp string(text)

Default value is empty.
bandsintown string(text)

Default value is empty.
biography string(text)

Default value is empty.
birthdate string(date)
city string(text)

Default value is empty.
created string(timestamp with time zone) Required

Default value is now().
email string(text)

Default value is empty.
facebook string(text)

Default value is empty.
id string(uuid) Required

Note: This is a Primary Key.

Default value is extensions.uuid_generate_v4().
instagram string(text)

Default value is empty.
legal_name string(text)

Default value is empty.
linkedin string(text)

Default value is empty.
mixcloud string(text)

Default value is empty.
phone string(text)

Default value is empty.
snapchat string(text)

Default value is empty.
songkick string(text)

Default value is empty.
soundcloud string(text)

Default value is empty.
spotify string(text)

Default value is empty.
stage_name string(text)

Default value is empty.
tiktok string(text)

Default value is empty.
twitch string(text)

Default value is empty.
updated string(timestamp with time zone) Required

Default value is now().
website string(text)

Default value is empty.
x string(text)

Default value is empty.
youtube string(text)

Default value is empty.
country string(text)

Default value is empty.
anr string(text)

Default value is empty.
is_signed boolean(boolean)

Default value is false.
org_id string(text)

Default value is empty.
soundcharts_id string(text)

Default value is empty.
metadata
streaming
followers
address string(text)

Default value is empty.
tracks
services

Responses

201

Created

POST /artists

curl \
 --request POST 'https://api.audiokit.ai:443/artists' \
 --header "Prefer: return=representation" \
 --data '{"apple_music":"","bandcamp":"","bandsintown":"","biography":"","birthdate":"2025-05-04","city":"","created":"now()","email":"","facebook":"","id":"extensions.uuid_generate_v4()","instagram":"","legal_name":"","linkedin":"","mixcloud":"","phone":"","snapchat":"","songkick":"","soundcloud":"","spotify":"","stage_name":"","tiktok":"","twitch":"","updated":"now()","website":"","x":"","youtube":"","country":"","anr":"","is_signed":false,"org_id":"","soundcharts_id":"","address":""}'

Request examples

# Headers
Prefer: return=representation

# Payload
{
  "apple_music": "",
  "bandcamp": "",
  "bandsintown": "",
  "biography": "",
  "birthdate": "2025-05-04",
  "city": "",
  "created": "now()",
  "email": "",
  "facebook": "",
  "id": "extensions.uuid_generate_v4()",
  "instagram": "",
  "legal_name": "",
  "linkedin": "",
  "mixcloud": "",
  "phone": "",
  "snapchat": "",
  "songkick": "",
  "soundcloud": "",
  "spotify": "",
  "stage_name": "",
  "tiktok": "",
  "twitch": "",
  "updated": "now()",
  "website": "",
  "x": "",
  "youtube": "",
  "country": "",
  "anr": "",
  "is_signed": false,
  "org_id": "",
  "soundcharts_id": "",
  "address": ""
}