SwitchBot

cloudProven against a real device on 2026-09-03by ALYT

SwitchBot meters, plugs and curtains, through the SwitchBot cloud and your hub.

What it adds to a house

adds sensors, switches and blinds.

How a person connects it

Method: form. The token and secret are in the SwitchBot app: Profile, Preferences, tap the version number ten times, Developer Options.

Field	Kind	Required
Token (token)	password, secret	yes
Secret (secret)	password, secret	yes

What it can look for

Yes: “Look for SwitchBot devices”.

What stops working when it is disconnected

The things it brought stop answering until it is connected again.

The descriptor

The same object the console and the phone render from, served for a program at /connectors/switchbot.json.

{
  "source": "built-in",
  "visibility": "public",
  "listed": true,
  "version": "1.0.0",
  "docsUrl": "https://developers.alyt.com/connectors/switchbot",
  "kind": "SWITCHBOT",
  "name": "SwitchBot",
  "icon": "thermometer",
  "promise": "SwitchBot meters, plugs and curtains, through the SwitchBot cloud and your hub.",
  "connectivity": "cloud",
  "brings": [
    "sensor",
    "switch",
    "cover"
  ],
  "connect": {
    "method": "form",
    "help": "The token and secret are in the SwitchBot app: Profile, Preferences, tap the version number ten times, Developer Options.",
    "fields": [
      {
        "key": "token",
        "label": "Token",
        "kind": "password",
        "secret": true,
        "required": true
      },
      {
        "key": "secret",
        "label": "Secret",
        "kind": "password",
        "secret": true,
        "required": true
      }
    ]
  },
  "discovery": {
    "verb": "Look for SwitchBot devices"
  },
  "disconnect": {
    "consequence": "{count} {things} stop answering until it is connected again."
  },
  "author": {
    "kind": "alyt",
    "name": "ALYT",
    "url": "https://alyt.com"
  },
  "verification": {
    "level": "proven",
    "at": "2026-09-03T23:05:00.000Z"
  }
}

The guide

SwitchBot connects through the SwitchBot cloud and your hub. In ALYT, it brings meters and sensors, plugs, and curtains or blinds into the home as sensor, switch, and cover devices. The household can see and control only what SwitchBot exposes through its cloud; when the internet is down, the home keeps working locally, but this connector cannot read or write until the cloud is back.

How to connect

The connect form asks for two required secret fields: token and secret. The token and secret come from the SwitchBot app under Profile, Preferences, then Developer Options. The page uses the form to send those credentials and list the account’s SwitchBot devices.

For a household, this is a one-time setup per SwitchBot account. If the credentials are wrong, the connection is refused and nothing is kept. A DEV key works in a sandbox; a LIVE key works only for its own connector.

What it discovers

Discovery means “Look for SwitchBot devices.” ALYT asks the connected SwitchBot account for its device list again and uses that list to create or refresh devices in the home.

What the household sees depends on the device type:

• meters and sensors become sensor
• plugs become switch
• curtains and blinds become cover

A hub is part of the path between SwitchBot devices and the cloud, but it is not a device the household controls here. Some devices may appear without a room until the household assigns them.

What it exposes

Sensors

SwitchBot meters and sensors can expose temperature, humidity, and battery. Some devices can also expose motion, contact, or air quality, depending on the SwitchBot device type. The household sees readings as live values from the cloud, not as stored history.

If a meter is out of range or the hub cannot hear it, ALYT reports that it is not answering rather than showing a fake zero reading.

Switches

Plugs expose on and off control through switch. The household can turn them on or off, and the connector refreshes the state after control so the home shows the latest result.

Covers

Curtains and blinds expose cover position control. The position is shown in the ALYT direction, not SwitchBot’s internal direction.

What it cannot do

• It is cloud only. It does not read directly from Bluetooth devices.
• It does not expose infrared remotes learned by a hub.
• It does not stream updates. State changes arrive when ALYT refreshes the connector.
• It does not make a hub itself into a controllable device.

What to check when it fails

If connection fails, check the token and secret from SwitchBot Developer Options in the app.

If a device does not answer:

• check the SwitchBot hub is powered and online
• check the device battery, if it has one
• move the device nearer to the hub if it is a meter or sensor
• refresh the connector after the cloud is back

If the household sees a device but no reading, treat it as a communication problem, not a value of zero. That matters for meters that the hub cannot hear.