Skip to main content

Getting Started

Introduction

Secure API for controlling Shelly devices through our cloud is available. Every registered user of the Shelly Cloud application can use this API to control hers/his devices.

Visit http://control.shelly.cloud to setup your account and devices, or use the mobile Shelly Cloud application.

With this API you can execute commands and change device settings.

Requirements

  • Active account for Shelly Cloud app
  • Your Shelly devices to be included into the app
note

Currently API calls are limited to one per second

Authorization key

You can generate an authorization key in the app in User settings->Authorization cloud key

danger

Do not share your Authorization key with anyone. Whoever has this key can control your Shelly devices.

note

The key will change if you change your password.

Server URI

A user account is assosiated with a server in our cloud infrastructure. Using this API requires knowing the host on which the user is a tenant of. The host is subject to change and is not guaranteed, as capacity considerations might lead to relocating tenants between cloud hosts.

The server uri can be obtained on the same page where the authorization key is generated

OAuth

OAuth based authentication is also possible. Take a look at Real Time Events section for more information