Canonical: https://mintisdynamics.com/connectors/switchbot

# SwitchBot

Open or close SwitchBot Curtains and see how far closed they are, or have a SwitchBot Bot press its button. Needs a SwitchBot Hub with Cloud Service on (Third-party Services, in app 9.0 and later).

- Verified: yes (https://docs-dev.mintisdynamics.com/get-started/verified)
- Published by: Mintis
- Provider: switchbot
- Kind: IoT
- Published: 2026-11-09
- Last reviewed: 2026-11-09
- How it runs: Runs through the service’s API. 2 of 5 actions ask first, confirmed with the same signal or a word.
- Your data: Lists your SwitchBot Curtains and Bots and sends curtain and button commands through your own SwitchBot account. Each response is kept in the Mintis audit log.

## Actions (5)

### Curtains

The SwitchBot Curtains on the account that the cloud can reach.

- Action: `curtains`
- Tier: only reads
- Presets:
  - List my curtains

### Open or close curtain

Move a curtain to open, half open or closed.

- Action: `curtain`
- Tier: asks first
- Presets:
  - Open {curtain}
  - Half open {curtain}
  - Close {curtain}

Parameters:

- `curtain` · Curtain · string · required — Which curtain, picked from the curtains the account has.
- `position` · Position · string · required — How far closed, in the provider's own form: index, mode (ff is the curtain's default mode) and position, 0 open to 100 closed. Options: Open (0,ff,0), Half open (0,ff,50), Closed (0,ff,100).
- `command` · Command · string · required
- `command_type` · Command type · string · optional

### Curtain position

How far a curtain is closed, from 0 (open) to 100 (closed), and whether it is still moving.

- Action: `curtain-status`
- Tier: only reads
- Presets:
  - How far closed is {curtain}

Parameters:

- `curtain` · Curtain · string · required — Which curtain, picked from the curtains the account has.

### Bots

The SwitchBot Bots, the button pushers, on the account that the cloud can reach.

- Action: `bots`
- Tier: only reads
- Presets:
  - List my button pushers

### Press button

Make a Bot press the button it is fitted to, once. What the press starts, such as a coffee machine, cannot be called back from here.

- Action: `press`
- Tier: asks first
- Presets:
  - Press {bot}

Parameters:

- `bot` · Bot · string · required — Which Bot, picked from the Bots the account has.
- `command` · Command · string · required
- `parameter` · Parameter · string · optional
- `command_type` · Command type · string · optional
