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

# Shelly

Switch Shelly plugs and switches on or off through Shelly Cloud. Connect with your server and authorization cloud key from the Shelly app (User settings, then Authorization cloud key); the key changes when your Shelly password does. Not for relays on gates or doors.

- Verified: yes (https://docs-dev.mintisdynamics.com/get-started/verified)
- Published by: Mintis
- Provider: shelly
- Kind: IoT
- Published: 2026-11-21
- Last reviewed: 2026-11-21
- How it runs: Runs through the service’s API. Every action asks first, confirmed with the same signal or a word.
- Your data: Lists your Shelly plugs and relays and switches the one you pick through your own Shelly Cloud account, on the server your Shelly app names. The Mintis audit log keeps each switch's response and the names and models of the plugs and relays you were shown.

## Actions (3)

### Turn a plug or relay on

Turn a Shelly plug, or the first output of a Shelly switch, on. It sets the state rather than toggling it, so a repeated fire changes nothing.

- Action: `turn-on`
- Tier: asks first
- Presets:
  - {id} on — Switch this plug or relay on.

Parameters:

- `id` · Plug or relay · string · required — Which plug or relay, picked from the plugs and relays on your Shelly account; a relay with several outputs is listed once, for its first.
- `channel` · Channel · integer · optional — The output of the plug or relay: the first, which is a plug's only one.
- `on` · On · boolean · required — Always on.

### Turn a plug or relay off

Turn a Shelly plug, or the first output of a Shelly switch, off. It sets the state rather than toggling it, so a repeated fire changes nothing.

- Action: `turn-off`
- Tier: asks first
- Presets:
  - {id} off — Switch this plug or relay off.

Parameters:

- `id` · Plug or relay · string · required — Which plug or relay, picked from the plugs and relays on your Shelly account; a relay with several outputs is listed once, for its first.
- `channel` · Channel · integer · optional — The output of the plug or relay: the first, which is a plug's only one.
- `on` · On · boolean · required — Always off.

### Plugs and relays

The Shelly plugs and relays on your account, by the names you gave them in the Shelly app; one with several outputs once, for its first.

- Action: `switches`
- Tier: asks first, only reads
- Presets:
  - List my Shelly plugs and relays
