Create individual tracks in your DISCO by providing a file location. You can include an external ID, metadata, custom fields, artwork, lyrics and tags.

Regardless of the filetype that is provided (e.g. mp3), DISCO will not read metadata from the file.

Include all necessary metadata in the body of the request when creating a new track.

On Transcoding

If you don't provide an mp3 or m4a, we will automatically create a mp3 of the provided lossless file (e.g. wav).

ℹ️

If you intend on using our API to upload 1000s of tracks to backfill your DISCO, please get in touch with us first so we can ensure your account is set for a most efficient transcoding process.

On Tags and Custom Fields

You can write (custom) track tags and custom fields information into a track. These need to be present in your DISCO to work.

For example, if you want to include a Genre tag that is not part of our default tags, such as EDM, you will need to create the tag in your DISCO before being able to include this tag with a track.

The same is true for custom fields.

Trying to write a tag or custom field that is not present in your DISCO will result in a 400 - key is not supported! error.

Other Errors

• Omitting the trailing / at the end of the URL will result in a 403 Forbidden error.
• Since we are fetching the audio file from the destination you specify, there may be errors where we cannot retrieve the file successfully. If that is the case, we will retry fetching the file up to 10 times. If we cannot retrieve the files, you may end up with a track that is missing its audio file. We can set up an email notification that is sent to an inbox of your choice to alert you if this occurs. Please let our support team know what this address should be.