API documentation

POST /sound_files

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/sound_files

Create Sound File.

Uploads a new Sound File, supplying a name, description, and the audio_file itself.

Params

Param name	Description
name Optional Blank value allowed	Name Must be a String
description Optional Blank value allowed	Description Must be a String
audio_file Optional Blank value allowed	Audio File Must be a valid file upload.
sound_playlist_ids Optional Blank value allowed	The Playlists this sound file belongs to. Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Sound Playlist. Refer to: /api/docs/1.0/sound_playlists
token_value_ids Optional Blank value allowed	Play this sound file only when the call matches these Tokens. Must be a valid array of integers. Each integer ID must be a valid foreign key reference to an Token Value. Refer to: /api/docs/1.0/token_values
record_token_filter_list Optional Blank value allowed	Assign filters to the object by passing an array of key:value pairs Must be a valid list of filters. Example filters: `"interest:auto", "loan_amount:>=10000", "loan_amount:<=50000", "geo:!=800", "caller_id:!=anonymous"`

Example Request

curl -X POST 'https://[your-subdomain].trackdrive.com/api/v1/sound_files/' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY' \
  -F 'name=Example Sound File' \
  -F 'description=Played at the start of a call' \
  -F 'audio_file=@greeting.mp3'

Example Response 201

{
  "status": 201,
  "success": true,
  "errors": {},
  "sound_file": {
    "id": 10001,
    "type": "SoundFile",
    "uuid": null,
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/sound_files/10001",
    "routes_edit_path": "/sound_files/10001/edit",
    "external_record_id": null,
    "company_id": 10002,
    "name": "Example Sound File",
    "description": "Played at the start of a call",
    "token_values_count": 0,
    "sound_playlist_ids": [],
    "audio_file_url": "/greetings/sound_file/audio_file/2-10001/a0d49c48545bcaaf801ee2f44f8f73cb/original/greeting.mp3",
    "record_token_filter_id": null,
    "record_token_filter_data_count": 0,
    "record_token_filter_data": []
  },
  "metadata": {
    "root": "sound_file"
  }
}