Skip to content

Add API Support for SwitchBot Presence Sensor (mmWave) #439

@agentcooper75

Description

@agentcooper75

Current Situation

The new SwitchBot Presence Sensor (mmWave) can be paired with the SwitchBot App via Bluetooth, and it reports accurate motion and presence data locally.
However, this device is currently not available through the SwitchBot Cloud API. It does not appear in the /v1.1/devices endpoint, and there are no accessible endpoints for reading its presence or motion states.
As a result, third-party platforms such as Home Assistant, HomeBridge, and Node-RED cannot detect or use this sensor.

Proposed Change

Please add full support for the SwitchBot Presence Sensor (mmWave) to the Cloud API.
Ideally, the device should:
Appear in the /v1.1/devices list with a dedicated deviceType (e.g. "Presence Sensor").
Provide an endpoint for retrieving current presence/motion status.
Provide an endpoint for reading the ambient light level (lux).
Optionally include mmWave-specific data such as distance, occupancy duration, and motion sensitivity.

Additional Context

This addition would enable smart home integrations (e.g. Home Assistant, Node-RED, HomeBridge) to use the Presence Sensor for occupancy-based automation and adaptive lighting.
Including both presence detection and light level data would allow for intelligent lighting and HVAC control.
Other SwitchBot devices (Meter, Contact Sensor, Hub 2, Curtain, etc.) are already accessible via the API, so extending this support to the Presence Sensor would greatly improve ecosystem compatibility.
Currently, the device operates only via Bluetooth and cannot be accessed through the SwitchBot Hub or Cloud.

Metadata

Metadata

Labels

enhancementNew feature or request

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions