Key requirements
To create a valid Sonos music service, you must:
-
Add the following core set of API requests, with valid success responses and error handling:
- APIs to add your content to Sonos. See content on Sonos.
- APIs to playback your content on Sonos. See playback on Sonos.
- An API to synchronize and update your content for Sonos users. See synchronize your service.
-
Handle pagination for large lists of content in the content API requests that support it. See Add pagination for details.
-
Return defined errors as expected. See error handling for details.
-
Use Transport Layer Security (TLS) and Secure Sockets Layer (SSL) security requirements in your SMAPI implementation. See security for details.
-
Handle all valid API calls, even if you don't support everything that they can do. See the SMAPI reference pages for details.
-
Requests will come from a central Sonos cloud service. To prevent any errors, allow traffic from the following IP addresses by whitelisting and removing any rate limiting:
Prod US Prod EU 44.215.7.120 3.254.19.106 44.205.206.64 54.228.149.139 52.44.15.120 52.215.51.102
Updated IP addresses to whitelist
As of October 3rd, 2025, Sonos has added the following IP Addresses:
Prod US Prod EU 98.90.227.221 34.248.241.0 3.217.225.201 54.246.214.31 98.89.207.195 54.76.21.251
As a Sonos content service partner, you decide which features to support. If you don't support a feature, your service must still send a reasonable, expected response. In your response, you can let the user know that your service does not support the requested feature.
Updated 5 days ago