What's New (developer release notes)

When Sonos releases new software, we share release notes with our users. Click the Software Version number in the table below to open these release notes. Click a link in the New Features and Updates section to learn how to add new functionality to your SMAPI service. See below for details about software version and build numbers.

If you're new to SMAPI, be sure to check out the Sonos Music API - Getting Started Guide.

Integrating a Music Service with Sonos


This document guides you through integrating your music service with Sonos. The table below summarizes the phases and time involved in making your service live on the Sonos app.

Phase Duration Description


A few hours to a day

Sonos Music API - Getting Started Guide

So you want to write music services for Sonos? You're in the right place!

Sonos Music API - Reference

After successfully integrating the content services of Pandora, Rhapsody, and Sirius Internet Radio into the Sonos system, we have learned a great deal about working with web-based content providers and proprietary APIs. In the interest of standardizing and moving forward the broader industry’s content-device integration process, Sonos and content partner Napster have developed an open API. The first instance of this API was used in a software update and Napster-Sonos integration released in October 2007.

Sonos Music API - Conceptual Overviews

This section includes additional conceptual overviews about features, browsing and search, content playback, and implementing SMAPI.

Troubleshooting Your SMAPI Implementation

Here are some common questions other partners have asked after starting their implementation. For more help, see questions tagged "sonos" on StackOverflow.

Why am I seeing so many getExtendedMetadata calls?

If you have implemented ratings or favorites, these capabilities can cause additional getExtendedMetadata requests. See the getExtendedMetadata documentation for details.

Frequently Asked Questions


What kind of music services are eligible to be added to the Sonos Platform?

Sonos Labs is intended for licensed and legal music services such as on demand, subscription, cloud-based access models and radio streaming services.

What is Multiple Account Support?

Sonos provides multiple account support for music services. Each person in a household with an account on your music service can add it to Sonos to play the music they love.

Sequence Diagrams

See the Sequence diagrams in this book for illustrations of communications between Sonos Player Groups, Sonos Controllers, and your Music Service.

Sonos Music API - Glossary

The following terminology is used to describe components of the Sonos system and the Sonos Music APIs.

container - an object containing a group of items potentially including both single elements and other containers. Containers are similar to folders or directories in file systems; they serve to create hierarchical trees and to keep like items together. Both playlists and albums are containers that contain track items.

Syndicate content