Skip to content
Spotted Docs Spotted Docs
DocumentationAPI Reference
API Reference
Me
Tracks

Save Tracks for Current User

me().tracks().save(TrackSaveParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
PUT/me/tracks

Save one or more tracks to the current user's 'Your Music' library.

ParametersExpand Collapse
TrackSaveParams params
List<String> ids

A JSON array of the Spotify IDs. For example: ["4iV5W9uYEdYUVa79Axb7Rh", "1301WleyT98MSxVHPZCA6M"]
A maximum of 50 items can be specified in one request. Note: if the timestamped_ids is present in the body, any IDs listed in the query parameters (deprecated) or the ids field in the body will be ignored.

Optional<Boolean> published

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Optional<List<TimestampedId>> timestampedIds

A JSON array of objects containing track IDs with their corresponding timestamps. Each object must include a track ID and an added_at timestamp. This allows you to specify when tracks were added to maintain a specific chronological order in the user's library.
A maximum of 50 items can be specified in one request. Note: if the timestamped_ids is present in the body, any IDs listed in the query parameters (deprecated) or the ids field in the body will be ignored.

String id

The Spotify ID for the track.

LocalDateTime addedAt

The timestamp when the track was added to the library. Use ISO 8601 format with UTC timezone (e.g., 2023-01-15T14:30:00Z). You can specify past timestamps to insert tracks at specific positions in the library's chronological order. The API uses minute-level granularity for ordering, though the timestamp supports millisecond precision.

formatdate-time

Save Tracks for Current User 

package dev.cjav.spotted.example;

import dev.cjav.spotted.client.SpottedClient;
import dev.cjav.spotted.client.okhttp.SpottedOkHttpClient;
import dev.cjav.spotted.models.me.tracks.TrackSaveParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        SpottedClient client = SpottedOkHttpClient.fromEnv();

        TrackSaveParams params = TrackSaveParams.builder()
            .addId("string")
            .build();
        client.me().tracks().save(params);
    }
}
Returns Examples