createGroup
Use the createGroup command in the groups namespace to create a new group from a list of players. The player returns a group object with the group ID. This may be an existing group ID if an existing group is a subset of the new group. In this case, Sonos may build the new group by adding new players to the existing group.
The group coordinator is chosen as follows. Sonos looks for existing groups whose members are all among the requested players (playerIds plus the players in areaIds), counting an ungrouped player as a group of one. It builds on the largest such group and keeps its coordinator, preferring the group that contains the first player in playerIds when sizes are equal. If there is no such group, the first player in playerIds becomes the coordinator.
Request
- Base URLhttps://api.ws.sonos.com/control/api/v1
- URLhttps://api.ws.sonos.com/control/api/v1/households/{householdId}/groups/createGroup
- AuthOAuth 2 and HTTP bearer and API key in header X-Sonos-Api-KeyAuthorization code: https://api.sonos.com/login/v3/oauthToken URL: https://api.sonos.com/login/v3/oauth/access scopes: playback-control-all
Request body
Response
Returns a groupInfo object, which currently only includes a group object. The groupInfo object may include additional information in the future.
Muse v2 sends playerSetError which includes playerIds array since version 1.17.0
Changes
No recorded changes to this operation across all 1 revision of this API.