Access: organization users with track permissions; X-User-Id may target a same-organization user where allowed.
POST
https://enterprise.spacemedia.uk
/
api
/
v1
/
tracks
Create Track
curl --request POST \
--url https://enterprise.spacemedia.uk/api/v1/tracks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Midnight Signals",
"artists": [
{
"id": 1042,
"type": "Primary Artist"
},
{
"id": 1043,
"type": "Composer"
}
],
"language": "English",
"primary_genre": "Electronic",
"iswc_code": "T-034.524.680-1",
"isrc_code": "GB-SMU-26-00001",
"lyrics": null,
"is_available_separately": true,
"is_parental_advisory": false,
"license_holder_year": 2026,
"license_holder_name": "Demo Label Group Ltd",
"notes": "Demo track used for public API examples.",
"metadata": {
"version": "Original Mix",
"secondary_genre": "Ambient"
},
"duration": 196,
"track_id": "track_demo_midnight_signals",
"links": [
"https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav",
"https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3"
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'Midnight Signals',
artists: [{id: 1042, type: 'Primary Artist'}, {id: 1043, type: 'Composer'}],
language: 'English',
primary_genre: 'Electronic',
iswc_code: 'T-034.524.680-1',
isrc_code: 'GB-SMU-26-00001',
lyrics: null,
is_available_separately: true,
is_parental_advisory: false,
license_holder_year: 2026,
license_holder_name: 'Demo Label Group Ltd',
notes: 'Demo track used for public API examples.',
metadata: {version: 'Original Mix', secondary_genre: 'Ambient'},
duration: 196,
track_id: 'track_demo_midnight_signals',
links: [
'https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav',
'https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3'
]
})
};
fetch('https://enterprise.spacemedia.uk/api/v1/tracks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://enterprise.spacemedia.uk/api/v1/tracks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Midnight Signals',
'artists' => [
[
'id' => 1042,
'type' => 'Primary Artist'
],
[
'id' => 1043,
'type' => 'Composer'
]
],
'language' => 'English',
'primary_genre' => 'Electronic',
'iswc_code' => 'T-034.524.680-1',
'isrc_code' => 'GB-SMU-26-00001',
'lyrics' => null,
'is_available_separately' => true,
'is_parental_advisory' => false,
'license_holder_year' => 2026,
'license_holder_name' => 'Demo Label Group Ltd',
'notes' => 'Demo track used for public API examples.',
'metadata' => [
'version' => 'Original Mix',
'secondary_genre' => 'Ambient'
],
'duration' => 196,
'track_id' => 'track_demo_midnight_signals',
'links' => [
'https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav',
'https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://enterprise.spacemedia.uk/api/v1/tracks"
payload = {
"title": "Midnight Signals",
"artists": [
{
"id": 1042,
"type": "Primary Artist"
},
{
"id": 1043,
"type": "Composer"
}
],
"language": "English",
"primary_genre": "Electronic",
"iswc_code": "T-034.524.680-1",
"isrc_code": "GB-SMU-26-00001",
"lyrics": None,
"is_available_separately": True,
"is_parental_advisory": False,
"license_holder_year": 2026,
"license_holder_name": "Demo Label Group Ltd",
"notes": "Demo track used for public API examples.",
"metadata": {
"version": "Original Mix",
"secondary_genre": "Ambient"
},
"duration": 196,
"track_id": "track_demo_midnight_signals",
"links": ["https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav", "https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": [
{
"id": "0b4edc61-cf2d-4a92-bb20-37051d52d2f8",
"title": "Midnight Signals",
"links": [
"https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav",
"https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3"
],
"metadata": {
"version": "Original Mix",
"secondary_genre": "Ambient"
},
"duration": 196,
"language": "English",
"iswc_code": "T0345246801",
"isrc_code": "GBSMU2600001",
"lyrics": null,
"is_available_separately": true,
"is_parental_advisory": false,
"license_holder_year": 2026,
"license_holder_name": "Demo Label Group Ltd",
"primary_genre": "Electronic",
"secondary_genre": "Ambient",
"track_version": "Original Mix",
"preview_url": "https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3",
"description": "Demo track used for public API examples.",
"notes": "Demo track used for public API examples.",
"input_format": "wav",
"output_format": "wav",
"original_file": "midnight-signals.wav",
"documents_requested": false,
"request_notice": null,
"viewUrl": "/releases/f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85/edit",
"uploaded_by": {
"id": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"uuid": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"organization_id": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"organization_uuid": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"name": "Maya Chen",
"full_name": "Maya Chen",
"first_name": "Maya",
"last_name": "Chen",
"email": "maya.chen@example.test",
"phone": "+442071838750",
"language": "en",
"country": "United Kingdom",
"address": "22 Demo Lane, London",
"photo": null,
"profile_photo": null,
"verified": true,
"email_verified_at": "2026-04-10T08:15:00+00:00",
"last_login_at": "2026-04-18T08:45:00+00:00",
"created_at": "2026-03-20T09:00:00+00:00",
"updated_at": "2026-04-18T08:45:00+00:00",
"is_suspended": false,
"suspended_at": null,
"invitation_status": "accepted",
"is_invited": false,
"roles": [
{
"id": "role-admin-demo",
"uuid": "role-admin-demo",
"name": "Admin"
}
]
},
"artists": [
{
"id": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"uuid": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"name": "Nova Vale",
"url": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"viewUrl": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"editRoute": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b/edit",
"artist_type": "Primary Artist",
"spotify_id": "6dDemoNovaVale",
"releases_count": 1,
"tracks_count": 2,
"total_releases": 1,
"total_tracks": 2,
"total_streams": 125000,
"metadata": {
"country": "GB"
},
"created_at": "2026-03-22T11:00:00+00:00",
"updated_at": "2026-04-15T10:20:00+00:00"
}
]
}
]
}{
"success": false,
"message": "Missing bearer token"
}{
"success": false,
"message": "This action is unauthorized."
}{
"success": false,
"message": "Resource not found"
}{
"success": false,
"message": "Validation failed.",
"errors": {
"title": [
"The title field is required."
]
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Use application/json for API responses.
Bearer access token. Use Bearer <YOUR_ACCESS_TOKEN>.
Optional user UUID to perform the request on behalf of a user in the same organization.
Body
application/json
The body is of type object.
Response
Success
The response is of type object.
Previous
Update TrackAccess: organization users with track permissions; `X-User-Id` may target a same-organization user where allowed.
Next
⌘I
Create Track
curl --request POST \
--url https://enterprise.spacemedia.uk/api/v1/tracks \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Midnight Signals",
"artists": [
{
"id": 1042,
"type": "Primary Artist"
},
{
"id": 1043,
"type": "Composer"
}
],
"language": "English",
"primary_genre": "Electronic",
"iswc_code": "T-034.524.680-1",
"isrc_code": "GB-SMU-26-00001",
"lyrics": null,
"is_available_separately": true,
"is_parental_advisory": false,
"license_holder_year": 2026,
"license_holder_name": "Demo Label Group Ltd",
"notes": "Demo track used for public API examples.",
"metadata": {
"version": "Original Mix",
"secondary_genre": "Ambient"
},
"duration": 196,
"track_id": "track_demo_midnight_signals",
"links": [
"https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav",
"https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3"
]
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'Midnight Signals',
artists: [{id: 1042, type: 'Primary Artist'}, {id: 1043, type: 'Composer'}],
language: 'English',
primary_genre: 'Electronic',
iswc_code: 'T-034.524.680-1',
isrc_code: 'GB-SMU-26-00001',
lyrics: null,
is_available_separately: true,
is_parental_advisory: false,
license_holder_year: 2026,
license_holder_name: 'Demo Label Group Ltd',
notes: 'Demo track used for public API examples.',
metadata: {version: 'Original Mix', secondary_genre: 'Ambient'},
duration: 196,
track_id: 'track_demo_midnight_signals',
links: [
'https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav',
'https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3'
]
})
};
fetch('https://enterprise.spacemedia.uk/api/v1/tracks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://enterprise.spacemedia.uk/api/v1/tracks",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Midnight Signals',
'artists' => [
[
'id' => 1042,
'type' => 'Primary Artist'
],
[
'id' => 1043,
'type' => 'Composer'
]
],
'language' => 'English',
'primary_genre' => 'Electronic',
'iswc_code' => 'T-034.524.680-1',
'isrc_code' => 'GB-SMU-26-00001',
'lyrics' => null,
'is_available_separately' => true,
'is_parental_advisory' => false,
'license_holder_year' => 2026,
'license_holder_name' => 'Demo Label Group Ltd',
'notes' => 'Demo track used for public API examples.',
'metadata' => [
'version' => 'Original Mix',
'secondary_genre' => 'Ambient'
],
'duration' => 196,
'track_id' => 'track_demo_midnight_signals',
'links' => [
'https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav',
'https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}import requests
url = "https://enterprise.spacemedia.uk/api/v1/tracks"
payload = {
"title": "Midnight Signals",
"artists": [
{
"id": 1042,
"type": "Primary Artist"
},
{
"id": 1043,
"type": "Composer"
}
],
"language": "English",
"primary_genre": "Electronic",
"iswc_code": "T-034.524.680-1",
"isrc_code": "GB-SMU-26-00001",
"lyrics": None,
"is_available_separately": True,
"is_parental_advisory": False,
"license_holder_year": 2026,
"license_holder_name": "Demo Label Group Ltd",
"notes": "Demo track used for public API examples.",
"metadata": {
"version": "Original Mix",
"secondary_genre": "Ambient"
},
"duration": 196,
"track_id": "track_demo_midnight_signals",
"links": ["https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav", "https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3"]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": [
{
"id": "0b4edc61-cf2d-4a92-bb20-37051d52d2f8",
"title": "Midnight Signals",
"links": [
"https://cdn.spacemedia.uk/demo/audio/midnight-signals.wav",
"https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3"
],
"metadata": {
"version": "Original Mix",
"secondary_genre": "Ambient"
},
"duration": 196,
"language": "English",
"iswc_code": "T0345246801",
"isrc_code": "GBSMU2600001",
"lyrics": null,
"is_available_separately": true,
"is_parental_advisory": false,
"license_holder_year": 2026,
"license_holder_name": "Demo Label Group Ltd",
"primary_genre": "Electronic",
"secondary_genre": "Ambient",
"track_version": "Original Mix",
"preview_url": "https://cdn.spacemedia.uk/demo/audio/midnight-signals-preview.mp3",
"description": "Demo track used for public API examples.",
"notes": "Demo track used for public API examples.",
"input_format": "wav",
"output_format": "wav",
"original_file": "midnight-signals.wav",
"documents_requested": false,
"request_notice": null,
"viewUrl": "/releases/f78c0f2e-4b30-4b33-87c5-e0bbd17b2b85/edit",
"uploaded_by": {
"id": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"uuid": "9d7046b2-3ab1-4c9d-9bd8-90bbd22b7df2",
"organization_id": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"organization_uuid": "2a8d3e82-4a9d-4e33-9d3b-85bb1a93e8d4",
"name": "Maya Chen",
"full_name": "Maya Chen",
"first_name": "Maya",
"last_name": "Chen",
"email": "maya.chen@example.test",
"phone": "+442071838750",
"language": "en",
"country": "United Kingdom",
"address": "22 Demo Lane, London",
"photo": null,
"profile_photo": null,
"verified": true,
"email_verified_at": "2026-04-10T08:15:00+00:00",
"last_login_at": "2026-04-18T08:45:00+00:00",
"created_at": "2026-03-20T09:00:00+00:00",
"updated_at": "2026-04-18T08:45:00+00:00",
"is_suspended": false,
"suspended_at": null,
"invitation_status": "accepted",
"is_invited": false,
"roles": [
{
"id": "role-admin-demo",
"uuid": "role-admin-demo",
"name": "Admin"
}
]
},
"artists": [
{
"id": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"uuid": "4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"name": "Nova Vale",
"url": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"viewUrl": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b",
"editRoute": "/artists/4cbb71fa-6e92-4a8b-9c3d-0b6811ef6f1b/edit",
"artist_type": "Primary Artist",
"spotify_id": "6dDemoNovaVale",
"releases_count": 1,
"tracks_count": 2,
"total_releases": 1,
"total_tracks": 2,
"total_streams": 125000,
"metadata": {
"country": "GB"
},
"created_at": "2026-03-22T11:00:00+00:00",
"updated_at": "2026-04-15T10:20:00+00:00"
}
]
}
]
}{
"success": false,
"message": "Missing bearer token"
}{
"success": false,
"message": "This action is unauthorized."
}{
"success": false,
"message": "Resource not found"
}{
"success": false,
"message": "Validation failed.",
"errors": {
"title": [
"The title field is required."
]
}
}