Fixed a bug with the create playlist endpoint in which omitting a description causes the description of the playlist to be the string null. See issue #75.

Author: Peter-Schorn

.swiftpm/xcode/xcshareddata/xcschemes/SpotifyAPI-Package.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1620"
+   LastUpgradeVersion = "1630"
    version = "1.7">
    <BuildAction
       parallelizeBuildables = "YES"

.swiftpm/xcode/xcshareddata/xcschemes/SpotifyAPI.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1620"
+   LastUpgradeVersion = "1630"
    version = "1.7">
    <BuildAction
       parallelizeBuildables = "YES"

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.0.2] - 05/08/2025
+
+* Fixed a bug with the create playlist endpoint in which omitting a description causes the description of the playlist to be the string `null`. See issue [#75](https://github.com/Peter-Schorn/SpotifyAPI/issues/75).
+
 ## [4.0.1] - 12/25/2024
 
 * Fixed a bug in which certain characters, such as the `+` character, were not being properly percent-encoded in `Dictionary.formURLEncoded()`. See [#70](https://github.com/Peter-Schorn/SpotifyAPI/pull/70).

Sources/SpotifyWebAPI/API/SpotifyAPI+Playlists.swift

@@ -862,13 +862,27 @@ public extension SpotifyAPI where
             let userId = try SpotifyIdentifier(
                 uri: userURI, ensureCategoryMatches: [.user]
             ).id
-            
+
+            // There is a bug with the spotify web API where if the description
+            // field is omitted entirely from the JSON (as opposed to explicitly
+            // setting it to null), then the description of the playlist will be
+            // the string `null`.
+            // See issue #75.
+            let modifiedPlaylistDetails = PlaylistDetails(
+                name: playlistDetails.name,
+                isPublic: playlistDetails.isPublic,
+                isCollaborative: playlistDetails.isCollaborative,
+                description: playlistDetails.description == nil
+                    ? ""
+                    : playlistDetails.description
+            )
+
             return self.apiRequest(
                 path: "/users/\(userId)/playlists",
                 queryItems: [:],
                 httpMethod: "POST",
                 makeHeaders: Headers.bearerAuthorizationAndContentTypeJSON(_:),
-                body: playlistDetails,
+                body: modifiedPlaylistDetails,
                 requiredScopes: []
             )
             .decodeSpotifyObject(