From 68d57c3341aaf6d523b181fa9b87f9f5a186a69a Mon Sep 17 00:00:00 2001 From: PeteRager Date: Mon, 8 Dec 2025 16:42:14 -0500 Subject: [PATCH 1/2] fix: add requirement for UPnP to be enabled --- source/_integrations/sonos.markdown | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/source/_integrations/sonos.markdown b/source/_integrations/sonos.markdown index fd12a054c1cb..a325a98c2272 100644 --- a/source/_integrations/sonos.markdown +++ b/source/_integrations/sonos.markdown @@ -28,6 +28,10 @@ ha_quality_scale: bronze The `sonos` integration allows you to control your [Sonos](https://www.sonos.com) wireless speakers from Home Assistant. It also works with IKEA Symfonisk speakers. +## Prerequisites + +UPnP must be enabled on your Sonos system for this integration to work. In the Sonos app, go to **Account** > **Privacy and Security** > **UPnP** and enable the setting. + {% include integrations/config_flow.md %} ## Feature controls & sensors @@ -482,3 +486,28 @@ sonos: This integration follows the standard integration removal process; no extra steps are required. {% include integrations/remove_device_service.md %} + +## Troubleshooting + +### 403 error when setting up the integration + +#### Symptom + +When setting up the integration you see the following error: + +``` +requests.exceptions.HTTPError: 403 Client Error: Forbidden for url: http://192.168.1.1:1400/DeviceProperties/Control +``` + +#### Description + +This error means UPnP is not properly enabled on your Sonos system. The integration requires UPnP to communicate with your Sonos devices. + +#### Resolution + +To fix this issue, enable UPnP on your Sonos system: + +1. Open the Sonos app on your phone or tablet. +2. Go to **Account** > **Privacy and Security** > **UPnP**. +3. Enable the **UPnP** setting. +4. Try setting up the integration again. From 164cdf3ca950c993411b22e299c763b69c260035 Mon Sep 17 00:00:00 2001 From: PeteRager Date: Mon, 8 Dec 2025 16:54:03 -0500 Subject: [PATCH 2/2] fix markdown --- source/_integrations/sonos.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/sonos.markdown b/source/_integrations/sonos.markdown index a325a98c2272..521def4053f7 100644 --- a/source/_integrations/sonos.markdown +++ b/source/_integrations/sonos.markdown @@ -495,7 +495,7 @@ This integration follows the standard integration removal process; no extra step When setting up the integration you see the following error: -``` +```txt requests.exceptions.HTTPError: 403 Client Error: Forbidden for url: http://192.168.1.1:1400/DeviceProperties/Control ```