play

Use the play command in the playback namespace to initiate group playback.

After a successful play command, if your app is subscribed to the playback namespace, it may first receive a playbackStatus event with PLAYBACK_STATE_BUFFERING before another event with PLAYBACK_STATE_PLAYING. Sonos players will buffer the audio ahead of time when possible, in order to provide the shortest time to play for the user, and to prevent any audio gaps between tracks.

Path Params
string
required

Target groupId

Headers
uuid
deprecated

Client API Key for the integration. Required in V1 but deprecated in V2.

uuid

Correlation UUID for data tracking purposes

Responses

400

The given resource/object identifier is invalid

401

A client has not provided authorization credentials to perform a command

403

A client does not have the correct permissions to perform a command

500

Sonos has experience an unexpected condition it is unable to recover from

503

Player is unable to reach the service.

Language
Credentials
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json