Link Search Menu Expand Document

Sonos SOAP Services

Every sonos speaker has several soap services. Each service has one or more actions you can call.

UPNP specifications

Sonos speaker follow the MediaServer:4 and MediaRenderer:3 specifications by the Open Connectivity Foundation. These documents can provide you with some extra guidelines.

All available services

Service Description
AlarmClock Control the sonos alarms
AudioIn  
AVTransport Service that controls stuff related to transport (play/pause/next/special urls)
ConnectionManager  
ContentDirectory Browse for local content
DeviceProperties Modify device properties, like led status and stereo pairs
GroupManagement  
GroupRenderingControl Volume related controls for groups. Group volume is the average volume of all players. Snapshot stores the volume ratio between players.
HTControl  
MusicServices External music services
QPlay  
Queue Modify and browse queues
RenderingControl Volume related controls
SystemProperties Manage system-wide settings, mainly account stuff.
VirtualLineIn  
ZoneGroupTopology Zone config stuff, eg getting all the configured sonos zones.

UPNP errors

These are the default UPNP errors.

Error code Description
400 Bad request
401 Invalid action
402 Invalid args
404 Invalid var
412 Precondition failed
501 Action failed
600 Argument value invalid
601 Argument value out of range
602 Optional action not implemented
603 Out of memory
604 Human intervention required
605 Sring argument too long
606 Action not authorized
607 Signature failure
608 Signature missing
609 Not encrypted
610 Invalid sequence
611 Invalid control URL
612 No such session

This file is automatically generated with @svrooij/sonos-docs, do not edit manually.