Bluetooth pairing and client disconnect via API?

Poll

New Member
Joined
Mar 12, 2026
Messages
2
Hi,

I’m currently integrating WiiM devices into a custom control system using the available HTTP/API commands.

I have a question regarding Bluetooth control.

Is there any API (documented or undocumented) that allows:
• triggering Bluetooth pairing mode remotely
disconnecting a currently connected Bluetooth device

At the moment it seems that pairing can only be initiated manually from the physical device, and I couldn’t find any API endpoint that exposes this functionality.

For control system integrations it would be extremely useful to:

  • start Bluetooth pairing remotely
  • force disconnect a connected client
Is this possible with the current firmware, or is it planned for a future update?

Thanks!
 
Hi,

I’m currently integrating WiiM devices into a custom control system using the available HTTP/API commands.

I have a question regarding Bluetooth control.

Is there any API (documented or undocumented) that allows:
• triggering Bluetooth pairing mode remotely
disconnecting a currently connected Bluetooth device

At the moment it seems that pairing can only be initiated manually from the physical device, and I couldn’t find any API endpoint that exposes this functionality.

For control system integrations it would be extremely useful to:

  • start Bluetooth pairing remotely
  • force disconnect a connected client
Is this possible with the current firmware, or is it planned for a future update?

Thanks!
Hi,
Do you need pairing or just connecting and disconnecting?

If the latter, I don't think you need an API.

Switching the input to Bluetooth automatically connects to the last connected device. Switching to a non-Bluetooth input automatically disconnects the device.

For Bluetooth output, the device automatically connects when it becomes active (powere on).
 
Hi,
Do you need pairing or just connecting and disconnecting?

If the latter, I don't think you need an API.

Switching the input to Bluetooth automatically connects to the last connected device. Switching to a non-Bluetooth input automatically disconnects the device.

For Bluetooth output, the device automatically connects when it becomes active (powere on).
Hi,

Thanks for the clarification.

In my case I specifically need the ability to trigger Bluetooth pairing mode remotely, not just connect or disconnect an already paired device.

The goal is to allow pairing without requiring any interaction from the end user on the physical device. In our control system we would ideally expose a simple “Bluetooth Pairing” button that puts the WiiM device into pairing mode.

At the moment it seems that pairing can only be initiated manually from the device itself, and switching the input to Bluetooth only reconnects the last paired device, which does not help when a new device needs to be paired.

So the requirement is essentially:

  • trigger Bluetooth pairing mode via API
  • without requiring a manual action on the device
  • and without necessarily changing the current audio source
Is there any way to achieve this with the current firmware?

Thanks again for your help.
 
Hi,

Thanks for the clarification.

In my case I specifically need the ability to trigger Bluetooth pairing mode remotely, not just connect or disconnect an already paired device.

The goal is to allow pairing without requiring any interaction from the end user on the physical device. In our control system we would ideally expose a simple “Bluetooth Pairing” button that puts the WiiM device into pairing mode.

At the moment it seems that pairing can only be initiated manually from the device itself, and switching the input to Bluetooth only reconnects the last paired device, which does not help when a new device needs to be paired.

So the requirement is essentially:

  • trigger Bluetooth pairing mode via API
  • without requiring a manual action on the device
  • and without necessarily changing the current audio source
Is there any way to achieve this with the current firmware?

Thanks again for your help.
I recommend submitting a ticket through the WiiM app's feedback section.

While I don't expect this to be helpful, holding down the play button on the WiiM remote for 5 seconds will put the WiiM device into pairing mode.
 
Back
Top